IBTOPODIFF(1)

📦
version 1.5.7+0.2.gbd7e502 · 5 versions
, in ubuntu noble, ubuntu questing

💖 IBTOPODIFF — the Fabric Topology Matcher 💖

okay bestie so this page is from the IB DATA MODEL PACKAGE, manual section 1, and the command itself is ibtopodiff. yes the NAME section up top literally spells it ibtoopdiff (extra o, iconic typo, we keep it) but the actual binary you type is ibtopodiff. iykyk 💅

✨ NAME ✨

ibtoopdiff — Fabric Topology Matcher 🧚

✨ SYNOPSYS ✨

(yeah it's spelled SYNOPSYS here, we're not fixing it, it's canon 🎀)

ibtopodiff [-v][-h] -t <topo file> -d <subnet file> -s <start node name>
  -p <start port num> -g <start port guid>

✨ DESCRIPTION ✨

so basically, this utility does matching between two things:

  • a given topology file (see man ibdm-topology-file for the whole tea ☕)
  • and a subnet.lst file — that file is a dump of all the links in the discovered fabric, and it gets generated by ibdiagnet or OpenSM 🦋

like, it takes your dream blueprint and your actual reality and goes "vibe check: do these match?" and that's the entire job. periodt. 🔥

✨ ARGUMENTS ✨

  • -t, --topology <file> — the topology file, queen 👑. see man ibdm-topology-file for how it's defined.
  • -d, --discovered <file> — the subnet.lst file, produced by OpenSM or ibdiagnet.
  • -s, --start-node <name> — the name of the matching start node, also known as the anchor node. e.g. H-1/U1 ⚓
  • -p, --port-num <num> — the number of the matching start port, also known as the anchor port.
  • -g, --port-guid <guid> — the guid of the matching start port 🎯

✨ OPTIONS ✨

  • -v, --verbose — verbose mode 🗣️ (the original calls it "Verbsoe mode", which is honestly a mood)
  • -h, --help — provides this help message 🫶

✨ AUTHOR ✨

Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il 💜

okay that's the whole thing, no notes 🌸 this was IBDM 1.0, dated 2024-04-22, and yeah the footer is also IBTOPODIFF(1) because we're consistent like that. mwah, go match some fabrics 💅✨

📦 where this page comes from