IBCHECKWIDTH(8)

💅 IBCHECKWIDTH(8) — the OpenIB Diagnostics glow-up ✨

okay bestie, so this is ibcheckwidth from the OpenIB Diagnostics corner of the universe, and it is lowkey one of the most useful little scripts in your InfiniBand toolkit. no cap. let's get into it 🫶

🌸 NAME 🌸

ibcheckwidth — find 1x links in IB subnet 👀

like. it goes looking for the skinny links. the ones running at 1x instead of going full throttle. it's giving detective energy fr fr 🔍

✨ SYNOPSIS ✨

ibcheckwidth [-h] [-v] [-N | -nocolor] [<topology-file> | -C ca_name -P
ca_port -t(imeout) timeout_ms]

that's the whole vibe. you either hand it a topology file, or you point it at a specific channel adapter and port and let it go do its thing 💫

🦋 DESCRIPTION 🦋

so here's the tea ☕

ibcheckwidth is a script. it takes a full topology file — the kind that was created by ibnetdiscover — and then it goes and scans the network to validate the active link widths. and then? it reports any 1x links it finds. periodt.

think of it as the friend who walks into the party, looks around, and immediately tells you which of your links is not pulling its weight. iconic behavior, honestly 👑

ngl, a 1x link can quietly be the reason your fabric isn't performing the way you thought it was, so this script is genuinely your bestie for a vibe check 🧚

🎀 OPTIONS 🎀

• -N | -nocolor — use mono rather than color mode 🖤 no color, just plain vibes. sometimes you just want it monochrome, and that's valid.
• -C <ca_name> — use the specified ca_name 📛 you're telling it exactly which channel adapter to talk to.
• -P <ca_port> — use the specified ca_port 🔌 and this one picks the port.
• -t <timeout_ms> — override the default timeout for the solicited mads ⏱️ you get to choose how long it waits before giving up on those mads. impatient? generous? your call, bestie.

and yeah, the synopsis also shows -h and -v in there — -h and -v — so those are hanging out in the usage line too ✨

🌈 SEE ALSO 🌈

• ibnetdiscover(8) — the one that makes the topology file in the first place 👑
• ibchecknode(8) — node checks, different vibe
• ibcheckportwidth(8) — the port-level cousin of this exact energy 💜

💖 AUTHOR 💖

Hal Rosenstock — <halr@voltaire.com> 🫶

fr fr, just remember: this script only knows what the topology file tells it, so if your ibnetdiscover output is stale, so is your drama 💀

okay that's the whole page, bestie — go forth and find those 1x links, you absolute main character 💅✨

this has been OpenIB Diagnostics, dated May 21, 2007, brought to you with love from the OpenIB crew 🎀 bye babes!! 🌸🦋