opaportinfo(1)

💖 NAME 💖

opaportinfo — bestie, this one shows you the configuration and state of a specified Intel(R) Omni-Path Host Fabric Interface (HFI) port, either on the local host or on a remote switch. (Host or Switch) energy fr fr.

It lives in the IFSFFCLIRG manual, and it's giving very much "I just want to know what my port is doing" main character vibes. ✨

🌸 Syntax 🌸

opaportinfo [-l  lid  [-m  dest_port]] [-h  hfi] [-p  port] [-v]

That's it. That's the whole summoning circle. 🕯️

🎀 Options 🎀

• -l lid — specifies the destination LID. Default is the local port. (yes, the default is just, like, right here at home 🏠)
• -m dest_port — specifies the destination port. Default is the port with the given LID. This one is useful to access switch ports. (switch besties, this is your moment 💅)
• -h hfi — specifies the HFI to send through/to. Default is the first HFI.
• -p port — specifies the port to send through/to. Default is the first port.

✨ the -h and -p combo menu ✨

so -h and -p together permit a whole variety of selections, and the way that each one means something specific is lowkey iconic:

• -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). like, it does NOT care what's active, it's picking that port periodt
• -h x -p y — HFI x, port y. (the most specific girlie of them all 🫶)

🦋 Debug Options 🦋

• -v — specifies the verbose output. And ooh, the way that additional invocations stack — -v -v ... — turns on debugging, openib debugging, and libibumad debugging. stack them like bracelets bestie, each one unlocks more 💀

🌈 Examples 🌈

okay here's what it actually looks like in the wild:

opaportinfo -p 1

opaportinfo -p 2 -h 2 -l 5 -m 18

no cap, that second one is doing a lot of work. 👑

💜 Description 💜

So here's the tea you genuinely need to know: to access switch ports using this command, the -l and -m options must be given. Both of them. Together. No skipping. 🙈

The -l option specifies the LID of switch port 0 — which is the logical management port for the switch — and -m specifies the actual switch port to access.

like, -l is the front desk and -m is the actual room you're trying to walk into. you need both or you're just standing in the lobby. 🚪

and that's the whole page, bestie!! This lil cutie is opaportinfo(1) from the IFSFFCLIRG (Man Page) set, brought to you by the lovely people at Intel Corporation, Copyright(C) 2015-2019. go check your ports, you're doing amazing, mwah 💖✨🎀