smpdump(8)

💖 smpdump(8) — dump InfiniBand subnet management attributes 💖

okay bestie, pull up a chair, we're doing Open IB Diagnostics today and the star of the show is smpdump. it lives in section 8 of your manual, she's iconic, she's a little cryptic, and she is going to tell you literally everything about a subnet management attribute if you ask her nicely. 🫶

---

✨ NAME ✨

smpdump — dump InfiniBand subnet management attributes 💅

---

✨ SYNOPSIS ✨

smpdump [options] <dlid|dr_path> <attribute> [attribute_modifier]

---

✨ DESCRIPTION ✨

so smpdump is your general purpose SMP utility, right? it goes and gets SM attributes from a specified SMA. that's the whole job. no drama, no side quests. 🎀

and the result? dumped in hex by default. that's just the vibe, we don't make the rules.

---

✨ OPTIONS ✨

here's where it gets good. buckle up, there's a lot, but every single one of them matters:

• dlid|drpath — the LID or the DR path to the SMA. like, where are we going, bestie? 📍
• attribute — the IBA attribute ID for the SM attribute. which one are we looking at?
• attribute_modifier — the IBA modifier for that SM attribute. optional lil garnish ✨
• -s, --string — prints strings in the packet if it possibly can. if it can, it will. 🌸

💫 Addressing Flags 💫

• -D, --Direct — the address you specified is a directed route.

Examples, and yes these are exact:

[options] -D [options] "0"          # self port
[options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...

(Note the second number in the path specified must match the port being used. This can be specified using the port selection flag '-P' or the port found through the automatic selection process.)

• -L, --Lid — the address you specified is a LID.

💫 Port Selection flags 💫

• -C, --Ca <ca_name> — use the specified ca_name.
• -P, --Port <ca_port> — use the specified ca_port.
• -Y, --pkey-idx <idx> — P_Key table index (0-65535, default 0) used for the outgoing SA/GMP MADs. heads up tho: SMP (SMI directed-route/LID-routed) MADs always use P_Key index 0. no exceptions, no cap. 💀

💫 Local port Selection 💫

Multiple port / multiple CA support, iykyk: when no IB device or port is specified (see the "local umad parameters" below 👀), the libibumad library picks the port to use by these criteria:

1. the first port that is ACTIVE.
2. if not found, the first port that is UP (physical link up).

and if you do specify a port and/or CA name, the libibumad library tries to fulfill your request, and will just fail if it can't. sorry babe, it tried. 😭

For example:

ibaddr                 # use the first port (criteria #1 above)
ibaddr -C mthca1       # pick the best port from "mthca1" only.
ibaddr -P 2            # use the second (active/up) port from the first available IB device.
ibaddr -C mthca0 -P 2  # use the specified port only.

💫 Debugging flags 💫

• -d — raise the IB debugging level. can be used several times (-ddd or -d -d -d). more d's more chaos ✨
• -e — show send and receive errors (timeouts and others). our little tattletale.
• -h, --help — show the usage message. the classic.
• -v, --verbose — increase the application verbosity level. can be used several times (-vv or -v -v -v).
• -V, --version — show the version info.

💫 Configuration flags 💫

• -t, --timeout <timeout_ms> — override the default timeout for the solicited mads. ⏳
• --config, -z <config_file> — specify alternate config file. Default: /etc/infiniband-diags/ibdiag.conf

---

✨ FILES ✨

💫 CONFIG FILE 💫

/etc/infiniband-diags/ibdiag.conf

a global config file is provided so you can set some of the common options for all the tools. see the supplied config file for details. one file to rule them all, main character energy fr fr 👑

---

✨ EXAMPLES ✨

Direct Routed Examples, get into it:

smpdump -D 0,1,2,3,5 16 # NODE DESC
smpdump -D 0,1,2 0x15 2 # PORT INFO, port 2

LID Routed Examples, part two:

smpdump 3 0x15 2        # PORT INFO, lid 3 port 2
smpdump 0xa0 0x11       # NODE INFO, lid 0xa0

---

✨ SEE ALSO ✨

smpquery (8) — go say hi, she's family 🦋

---

✨ AUTHOR ✨

Hal Rosenstock < <halr@voltaire.com> >

---

okay and that's the whole page, bestie, you ate that. 💖

to send you off with the receipts: this one's straight out of the Open IB Diagnostics set, stamped 2017-08-21, and it belongs to manual section 8 — so smpdump(8), periodt. 🎀✨🌈