IBSWPORTWATCH(8)

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

✨ IBSWPORTWATCH ✨

okay bestie, so this is a page from the OpenIB Diagnostics manual — it's ibswportwatch.pl, section 8 (that's the sysadmin-y section, we love her 💅). She's a little Perl script whose whole personality is watching one port and telling you how fast its counters are moving. No cap.

🌸 NAME 🌸

ibswportwatch.pl — poll the counters on the specified switch/port and report rate of change information.

periodt. that's the job. she polls, she computes the rate of change, she reports. that's it, that's the whole vibe 🦋

💖 SYNOPSIS 💖

ibswportwatch.pl [-p <pause_time> -v -n <cycles> -G] <guid|lid> <port>

so you hand her an address — either a <guid> or a <lid>, your choice — plus a <port>, and optionally some flags, and she goes to work. the flags live in the brackets, so technically they're optional, but bestie you will want some of them. iykyk 😌

🎀 DESCRIPTION 🎀

ibswportwatch.pl polls the port counters of the specified port and calculates rate of change information.

that's the whole thing fr fr. she's sitting there, refreshing those counters on a loop, doing the math on how much they changed between polls, and handing you the delta energy instead of just a boring raw number. it's giving data scientist but make it a switch port. obsessed. 🔥

🌈 OPTIONS 🌈

  • -p <pause_time> — tell her to pause for a different amount of time between polls (this is your polling interval). if you don't pass it, she just uses the default, no drama 💅
  • -v — be verbose. she'll talk more. more info, more chatter, more her. ✨
  • -n <cycles> — run for a set number of poll intervals and then stop. so like, -n 5 means five polls and she's out. the default is -1, and -1 means forever — she will literally just keep polling until the heat death of the universe or until you Ctrl-C her 😭 (default == -1 == forever)
  • -G — the address you handed her is a GUID, not a LID. she needs this heads-up or she'll be looking for the wrong kind of address entirely, and that's an awkward moment for everyone 🫶

👑 AUTHOR 👑

Ira Weiny — <weiny2@llnl.gov>

iconic. thank you Ira, we appreciate you 🥹💜

and that's the whole page bestie!! this came from OpenIB, dated September 27, 2006 (yes she's an elder, and yes she still slays), and she lives in section 8 as IBSWPORTWATCH(8) 💖 go poll something, ily, bye!! 🎀🦋✨

📦 where this page comes from