IBDISCOVER.PL(8)

📦 version 61.1^20260812git975bdaf, in fedora 43, fedora 44

💫 IBDISCOVER.PL(8) 💫

ok so bestie, we're talking about ibdiscover.pl from the OpenIB Diagnostics crew, and it's genuinely one of those little scripts that does so much. sit with me, hydrate, and let's get into it. 🫶

✨ NAME ✨

ibdiscover.pl — annotate and compare InfiniBand topology

like... it literally labels your fabric and then tells you what changed. main character behaviour fr. 👑

🌸 SYNOPSIS 🌸

ibdiscover.pl

that's it. no flags, no args, no drama. she just runs. 💅

🦋 DESCRIPTION 🦋

ok so here's the whole vibe. ibdiscover.pl takes a topology file that was created by ibnetdiscover, plus a discover.map file that the network administrator creates which says which nodes you're expecting to see, plus an ibdiscover.topo file which is the expected connectivity.

from all that, she produces a brand new connectivity file called discover.topo.new and outputs the changes to stdout. 😭 iconic.

the network administrator can then choose to replace the "old" topo file with the new one — or just certain changes in it. dealer's choice, bestie. ✨

🎀 the syntax of the ibdiscover.map file 🎀

it goes like this:

<nodeGUID>|port|"Text for node"|<NodeDescription from ibnetdiscover format>

e.g.

8f10400410015|8|"ISR 6000"|# SW-6IB4 Voltaire port 0 lid 5

8f10403960558|2|"HCA 1"|# MT23108 InfiniHost Mellanox Technologies

see? pipe-separated, cute and tidy. 💖

🧚 the syntax of the old and new topo files 🧚

that's ibdiscover.topo and ibdiscover.topo.new, and they look like:

<LocalPort>|<LocalNodeGUID>|<RemotePort>|<RemoteNodeGUID>

e.g.

10|5442ba00003080|1|8f10400410015

and btw — these topo files are produced by the ibdiscover.pl tool itself. she makes her own receipts. no cap. 🔥

🌈 USAGE 🌈

ibnetdiscover | ibdiscover.pl

pipe it straight in, bestie. that's the whole flow. 🌸

⭐ SEE ALSO ⭐

💜 AUTHOR 💜

Hal Rosenstock <halr@voltaire.com>

heads up gorgeous: this one's all about comparing expected vs actual fabric, so if your discover.map is lying to you, the diff will absolutely read you for filth. keep it accurate. 💀

and that's the page, bestie!! this cutie comes to you from OpenIB and it's dated September 21, 2006 — vintage but still serving. 🎀💖✨

📦 where this page comes from