ibfindnodesusing(8)

💖 ibfindnodesusing — the find-your-nodes-through-this-switch-port tool 💖

okay bestie, so this is a page from the Open IB Diagnostics girlies, filed under section 8 of the manual. It's called ibfindnodesusing(8) and it is literally the "who is hiding behind this link" detector. Let's get into it 💅

---

✨ NAME ✨

ibfindnodesusing — find a list of end nodes which are routed through the specified switch and port

no cap, that's the whole mission statement. it finds your ends. through a switch port. iconic. 🎀

---

🌸 SYNOPSIS 🌸

ibfindnodesusing.pl [options] <switch_guid|switch_name> <port>

---

🦋 DESCRIPTION 🦋

so here's the tea 🍵: ibfindnodesusing.pl uses ibroute, and from that it detects the current nodes which are routed through both directions of the link you specified.

the link gets specified by one switch port end only. you hand over a single end, and the script finds the remote end automatically. it does the other half of the work for you. queen behavior. 👑

---

💅 OPTIONS 💅

• -h — show help. your little "wait what do I do" button 🫶
• -R — Recalculate the ibnetdiscover information, ie do not use the cached information. This option is slower but should be used if the diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed.

⚠️ yes it's slower, but stale cache is a crime. if the fabric might have changed, take the -R pill. 🔥

• -C <ca_name> — use the specified ca_name.
• -P <ca_port> — use the specified ca_port.

---

🍓 FILES 🍓

📁 CONFIG FILE 📁

/etc/infiniband-diags/ibdiag.conf

A global config file is provided to set some of the common options for all tools. See supplied config file for details.

it's giving "one config to rule them all" ✨

🧚 NODE NAME MAP FILE FORMAT 🧚

The node name map is used to specify user friendly names for nodes in the output. GUIDs are used to perform the lookup.

This functionality is provided by the opensm-libs package. See opensm(8) for the file location for your installation.

Generically:

# comment
<guid> "<name>"

Example:

# IB1
# Line cards
0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"

# Spines
0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"

# GUID   Node Name
0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"

like yes, give your racks cute names. they deserve it. 🌈

---

👑 AUTHOR 👑

Ira Weiny <<ira.weiny@intel.com>>

---

and that's the whole page, bestie 🫶 this version of ibfindnodesusing(8) comes from Open IB Diagnostics, dated 2017-08-21 — go forth and find those nodes, you absolute legend 💜✨