IBCHECKERRS(8)

💖 IBCHECKERRS(8) — bestie edition 💖

okay so this is ibcheckerrs from the OpenIB Diagnostics corner of the universe, and she is here to do a vibe check on your InfiniBand ports. Let's go. ✨

🌸 NAME 🌸

ibcheckerrs — validate IB port (or node) and report errors in counters above threshold 🩺

🎀 SYNOPSIS 🎀

ibcheckerrs [-h] [-b] [-v] [-G] [-T <threshold_file>]
[-s(how_thresholds)] [-N | -nocolor] [-C ca_name] [-P ca_port]
[-t(imeout) timeout_ms] <lid|guid> <port>

✨ DESCRIPTION ✨

So basically, bestie: you point this at a specific port (or a whole node), and it checks whether any of the error counters have surpassed their predefined threshold. If they have, it reports them. It's giving "snitch, but for your fabric." 👀

The port address is a lid, unless you bring the -G option, in which case you're speaking GUID. 🦋

Wanna see what the predefined thresholds actually are? Dump them with the -s option, no cap. And if you're feeling like a main character and want your own numbers, you can pass a user defined threshold_file with the -t <file> option — it uses the same format as the dump, so you can literally just copy the vibe. 💅

💜 OPTIONS 💜

• -G — use GUID address argument. In most cases, it's the Port GUID. Example: "0x08f1040023" ✨
• -s — show predefined thresholds 👑
• -T — use specified threshold file 📄
• -v — increase the verbosity level. louder. more. yes. 📢
• -b — brief mode. Reduce the output to show only if errors are present, not what they are. Like a spoiler-free recap. 🙈
• -N | -nocolor — use mono rather than color mode. sad beige output for sad beige terminals. 🎨
• -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. ⏰

heads up bestie: the synopsis also lists -h. That's all the original tells us about it, so I'm not gonna make stuff up about what it does. iykyk. 🫶

🌈 EXAMPLE 🌈

ibcheckerrs 2           # check aggregated node counter for lid 2

ibcheckerrs 2   4       # check port counters for lid 2 port 4

ibcheckerrs -T xxx 2    # check node using xxx threshold file

🦋 SEE ALSO 🦋

perfquery(8), ibaddr(8)

⭐ AUTHOR ⭐

Hal Rosenstock <halr@voltaire.com>

and that's the whole page, bestie — OpenIB, May 30, 2007, mwah 💋 no cap, go check those counters. 🌸💖🎀