IBCHECKPORTSTATE(8)

💖 IBCHECKPORTSTATE(8) — the ibcheckportstate glow-up 💖

okay bestie, so ibcheckportstate is a lil OpenIB Diagnostics tool and its whole personality is: "is this IB port actually up and vibing, or is it giving nothing?" ✨

🌸 NAME 🌸

ibcheckportstate — validate IB port for LinkUp and not Active state

(yes that's the actual one-liner, we keep it fr fr 💅)

🦋 SYNOPSIS 🦋

ibcheckportstate [-h] [-v] [-N | -nocolor] [-G] [-C ca_name] [-P
ca_port] [-t(imeout) timeout_ms] <lid|guid> <port>

like... it's a lot of flags but we're gonna go through every single one, no skipping, periodt 👑

✨ DESCRIPTION ✨

So what this does: it checks connectivity, and it checks that the port you point at has the right port state (which should be Active) and the right port physical state (which should be LinkUp). That's the vibe check. 🩺

And the port address you hand it is a lid, unless you use the -G option, in which case it's a GUID address instead. iykyk 💜

🎀 OPTIONS 🎀

• -G — use a GUID address argument instead of a lid. In most cases it's the Port GUID. Example they give: "0x08f1040023" — yes with the quotes, keep the quotes bestie 🫶
• -v — crank up the verbosity level, more talking, more lore 🗣️
• -N | -nocolor — use mono rather than color mode. lowkey sad but sometimes you need it 🎨➡️⬜
• -C <ca_name> — use the specified ca_name. 👑
• -P <ca_port> — use the specified ca_port. 🔌
• -t <timeout_ms> — override the default timeout for the solicited mads. not the vibe timeout, the actual milliseconds one ⏱️

also there's a -h up in the synopsis which is the classic help flag moment, iconic as always 🌈

🌟 EXAMPLE 🌟

ibcheckportstate 2 3         # check lid 2 port 3

look at her go 😭 lid 2, port 3, checked, done, slayed. ✨

👀 SEE ALSO 👀

smppquery... no wait, it's smpquery(8), and ibaddr(8). go read those too, they're the sibling energy 💞

💜 AUTHOR 💜

Hal Rosenstock — <halr@voltaire.com> 🫶

okay that's the whole page, and the sign-off goes a lil something like this: this was the OpenIB era, dated May 21, 2007 — a vintage queen fr fr 💅✨ bye bestie, go check those ports 🌸