ibstat(8)

💖 ibstat(8) — the InfiniBand vibe check 💖

okay bestie, so you know how you just need to know what your InfiniBand devices are doing but ibstatus is out here being a whole script? yeah. this is that but as a binary, and it's giving main character energy. it's called ibstat and it lives in the Open IB Diagnostics corner of the man pages.

---

✨ NAME ✨

ibstat — query basic status of InfiniBand device(s). she just wants to know how your CAs are doing 🫶

---

🌸 SYNOPSIS 🌸

ibstat [options] <ca_name> [portnum]

---

🦋 DESCRIPTION 🦋

so ibstat is a binary that displays basic information obtained from the local IB driver. no cap. the output includes LID, SMLID, port state, link width active, and port physical state. it's literally the gossip column for your ports 💅

she's similar to the ibstatus utility, except she's implemented as a binary rather than a script. and because she's That Girl, she has options to list CAs and/or ports and she displays more information than ibstatus. obsessed, honestly. ✨

---

👑 OPTIONS 👑

• -l, --list_of_cas — list all IB devices. every single one. she knows them all 💜
• -s, --short — short output. minimal words, maximum slay.
• -p, --port_list — show port list 🎀
• ca_name — InfiniBand device name (the one you're simping for)
• portnum — port number of InfiniBand device

---

🐛 Debugging flags 🐛

• -d — raise the IB debugging level. may be used several times (-ddd or -d -d -d). go off, honestly.
• -h, --help — show the usage message. your bestie when you're lost 🙈
• -v, --verbose — increase the application verbosity level. may be used several times (-vv or -v -v -v). she will NOT stop talking and we love that for her 💀
• -V, --version — show the version info. periodt.

---

🎀 Configuration flags 🎀

• --config, -z <config_file> — specify alternate config file.
  • Default: /etc/infiniband-diags/ibdiag.conf ⭐

---

🌈 EXAMPLES 🌈

no because these are so iconic, look:

ibstat            # display status of all ports on all IB devices
ibstat -l         # list all IB devices
ibstat -p         # show port guids
ibstat mthca0 2   # show status of port 2 of 'mthca0'

iykyk 😌

---

💫 SEE ALSO 💫

• ibstatus (8)

---

💅 AUTHOR 💅

Hal Rosenstock < <halr@voltaire.com> >

---

ngl bestie, this page is from the Open IB Diagnostics collection — ibstat(8) — dated 2017-08-21 and she's still serving looks. go check your ports, you're doing amazing, mwah 🫶💖✨