sminfo(8)

💅 NAME

okay so bestie, welcome to sminfo — it's the tool that queries the InfiniBand SMInfo attribute. That's it, that's the whole vibe check. It lives in the Open IB Diagnostics family, and it's filed under section 8 because it's a sysadmin-y system tool, iykyk. 🫶

---

✨ SYNOPSIS

sminfo [options] sm_lid | sm_dr_path [modifier]

---

🦋 DESCRIPTION

So basically ✨ — you can optionally set stuff and also display the output of a sminfo query in a human readable format. Two for one, we love that for us.

The target SM it talks to is the one listed in the local port info by default. OR, if you feel like it, you can point it at the SM specified by the optional SM lid, or by the SM direct routed path. Your choice, queen. 👑

⚠️ okay so listen, this is the important part: using sminfo for any purposes other than a simple query may be very dangerous, and may result in a malfunction of the target SM. Not a vibe. Not slay. Do not do it unless you truly know what you're doing. 🙈

---

🎀 OPTIONS

Here's the whole menu, bestie. No skipping, we're doing all of them. 💖

• -s, --state <state> — set the SM state. The values are:

0 — not active

1 — discovering

2 — standby

3 — master

• -p, --priority <priority> — set priority. Range is (0-15).
• -a, --activity <val> — set the activity count.

💫 Addressing Flags

• -D, --Direct — the address you're giving it is a directed route.

Examples:

[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.)

• -G, --Guid — the address you're giving it is a Port GUID.
• -L, --Lid — the address you're giving it 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. Meanwhile SMP (SMI directed-route/LID-routed) MADs always use P_Key index 0. That's just how it is, no notes. 💅

🌸 Local port Selection

Multiple port / Multiple CA support, okay so here's the tea: when no IB device or port is specified (peep the "local umad parameters" below), the libibumad library picks the port for you using these criteria:

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

If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible. F around and find out energy, honestly. 😭

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. May be used several times (-ddd or -d -d -d). Stack it like bracelets bestie. ✨
• -e — show send and receive errors (timeouts and others).
• -h, --help — show the usage message.
• -v, --verbose — increase the application verbosity level. May 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.
• -y, --m_key <key> — use the specified M_key for requests. If a non-numeric value (like 'x') is specified then a value will be prompted for.
• --config, -z <config_file> — specify an 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 at once. Iconic, honestly. See the supplied config file for details. 🎀

---

🌈 EXAMPLES

sminfo                  # local port\'s sminfo
sminfo 32               # show sminfo of lid 32
sminfo  -G 0x8f1040023  # same but using guid address

---

👑 SEE ALSO

• smpdump (8)

---

💖 AUTHOR

Hal Rosenstock — <halr@voltaire.com> 🌟

---

and that's the whole page bestie, no cap. this lil' beauty comes to you from the Open IB Diagnostics gang, dated 2017-08-21, and yes it is literally filed as sminfo(8). go query something (safely!), ily, bye. 💅✨🦋