IBPRINTSWITCH(8)

πŸ“¦ version 61.1^20260812git975bdaf, in fedora 43, fedora 44

πŸ’… IBPRINTSWITCH β€” like, the ibprintswitch.pl era πŸŽ€

ok so bestie, welcome to IBPRINTSWITCH(8), part of the OpenIB Diagnostics fam. yes it's a section 8 page, yes it's giving admin-tools-only, and yes we're gonna make it cute. sit down, hydrate, let's go πŸ¦‹


✨ NAME ✨

ibprintswitch.pl β€” prints either the switch you asked for, or a whole list of switches, straight out of the ibnetdiscover output. iconic behavior honestly πŸ’–


✨ SYNOPSIS ✨

ibprintswitch.pl [-R -l -C <ca_name> -P <ca_port>]
[<switch_guid|switch_name>]

✨ DESCRIPTION ✨

ok so real talk: it's faster than greping or opening the ibnetdiscover output in an editor. not me being efficient, we love that. ibprintswitch.pl will parse out and print either:

  • the switch info for the one switch you specified, or
  • a list of all the switches it found in the subnet.

and that's not even the whole slay. it also does a crude parse on the node description info β€” and if it finds something, it reports all the info for an entire chasis when the description info is consistent. yes, "crudely", that's the actual word, it's not me being shady, that's just what it does πŸ™ˆ

and finally β€” the part that's giving main character energy β€” ibprintswitch.pl will also reuse the cached ibnetdiscover output from some of the other diag tools, which makes it a lil bit faster than running ibnetdiscover from scratch. ✨ efficiency queen ✨


✨ OPTIONS ✨

  • -l β€” list the switches. that's it, that's the whole vibe. it's simply a wrapper for ibswitches. πŸ’…
  • -R β€” recalculate the ibnetdiscover information, aka do NOT use the cached info. yes it's slower. yes you should still use it if the diag tools haven't been used in a while, or if there's literally any other reason to believe the fabric has changed. no cap. πŸ”₯
  • -C <ca_name> β€” use the specified ca_name for the search. πŸŽ€
  • -P <ca_port> β€” use the specified ca_port for the search. πŸŽ€

✨ AUTHORS ✨

the legends themselves, give them their flowers 🌸:

  • Ira Weiny β€” <weiny2@llnl.gov> πŸ’–
  • Hal Rosenstock β€” <halr@voltaire.com> πŸ’–

bestie reminder: keep the cache fresh or hit -R, because stale fabric data is not the vibe. πŸ’€

and that's the page!! OpenIB, dated May 31, 2007, page IBPRINTSWITCH(8) β€” we stan a classic. mwah, go print some switches πŸ«Άβœ¨πŸ‘‘

πŸ“¦ where this page comes from