opainfo(1)

opainfo(1) 💖

okay bestie, welcome to opainfo from the IFSFFCLIRG</> manual set — she's the girl who walks up to your local HFI port(s) and just tells you everything about them. Summary info, no cap. Let's get into it 🫶

✨ NAME ✨

opainfo — gives you the tea on your local HFI port(s). Like, a full summary of what's going on in there. 👑

🌸 SYNTAX 🌸

opainfo [-h  hfi] [-p  port] [-o  type] [-g] [-d  detail] [-s pm_sl]
[-v [-v]...]

💅 OPTIONS 💅

• --help — spills the full help text. the whole thing. every word. iconic of her honestly.
• -h hfi — picks which HFI you're talking about, numbered 1..n. if you pass 0, that means the -p port you gave is a system-wide port number instead. default is 0. (iykyk)
• -p port — picks the port, numbered 1 to n. passing 0 = first active port across all HFIs/ports. default is 1, which means all ports. and if it's selected but p isn't actually defined? she still hands you info on all the available ports, generous queen 💖
• -o type — sets the output type, and bestie you can pass this more than once. stack 'em.

NOTE: if you don't use -o at all, you get a brief summary of portinfo, counters and cableinfo. that's the default vibe.

• info — outputs detailed portinfo. 📋
• stats — outputs detailed port counters. 📊

• -g — output comes out in line-by-line format. default is summary format.
• -d detail — sets the output detail level. range is 0 - 2. CableInfo only. default is 0.

NOTE: the -d option gets ignored when you use it with -o type. not me warning you twice 🫠

• 0 — minimal crucial information (for example, cable length, vendor)
• 1 — brief summary
• 2 — extended brief summary

• -s pm_sl — specifies a different Service Level for PMA traffic.

🎀 -h and -p OPTIONS PERMIT A VARIETY OF SELECTIONS 🎀

like a lil menu, pick your fighter:

• -h 0 — First active port in system (Default).
• -h 0 -p 0 — First active port in system.
• -h x — First active port on HFI x.
• -h x -p 0 — First active port on HFI x.
• -h 0 -p y — Port y within system (no matter which ports are active).
• -h x -p y — HFI x, port y.

🦋 DEBUG OPTIONS 🦋

• -v — verbose output. and the way that you can keep adding them (-v -v ...) to turn on debugging, openib debugging, and libibumad debugging?? obsessed. 🔥

🌈 EXAMPLES 🌈

opainfo

  hfi1_0:1 PortGID:0xfe80000000000000:001175010165b19c

  PortState:     Active

  LinkSpeed Act: 25Gb En: 25Gb

  LinkWidth Act: 4 En: 4

  LinkWidthDnGrd ActTx: 4 Rx: 4 En: 3,4

  LCRC Act: 14-bit En: 14-bit,16-bit,48-bit Mgmt: True

  LID: 0x00000001-0x00000001 SM LID: 0x00000002 SL: 0

  QSFP: PassiveCu, 1m FCI Electronics P/N 10131941-2010LF Rev 5

  Xmit Data:           22581581 MB Pkts:           5100825193

  Recv Data:           18725619 MB Pkts:           4024569756

  Link Quality: 5 (Excellent)

look at her go. link quality 5 (Excellent) — main character energy fr fr ✨

Copyright(C) 2015-2019 Intel Corporation — yeah, that's the whole copyright/version situation, and this page lives under opainfo(1) in the IFSFFCLIRG manual. mwah, go check your ports bestie 💜🎀