IBPING(8)

💖 IBPING — ping an InfiniBand address 💖

okay bestie, so the manual name is IBPING (it lives in section 8, the big-girl admin section, iykyk) and it's part of Open IB Diagnostics 🦋 she's from 2012-05-14 and yes she still ate.

---

✨ SYNOPSIS ✨

ibping [options] <dest lid | guid>

---

🌸 DESCRIPTION 🌸

so ibping uses vendor mads to validate connectivity between IB nodes 💅 like it's literally checking "hey can these two talk to each other" and it does it with vendor mads, no cap.

on exit, you get (IP) ping like output — yep, it's giving classic ping energy but for IB 🎀

and here's the whole vibe: ibping runs as client/server. default is to run as a client. also bestie, note that a default ping server is implemented within the kernel 👑 so the kernel already has your back.

---

💅 OPTIONS 💅

• -c, --count — stop after count packets. like, we're done here, no more 🛑
• -f, --flood — flood destination: send packets back to back without delay 🔥 full send, zero chill
• -o, --oui — use specified OUI number to multiplex vendor mads
• -S, --Server — start in server mode (do not return). you become the server, main character energy, and you do NOT come back 🙈

🎀 Addressing Flags 🎀

• -L, --Lid — The address specified is a LID
• -G, --Guid — The address specified is a Port GUID
• -s, --sm_port <smlid> — use smlid as the target lid for SA queries.

🌈 Port Selection flags 🌈

• -C, --Ca <ca_name> — use the specified ca_name.
• -P, --Port <ca_port> — use the specified ca_port.
• -Y, --pkey-idx <idx> — P_Key table index (0-65535, default 0) used for the outgoing SA/GMP MADs. SMP (SMI directed-route/LID-routed) MADs always use P_Key index 0. ⭐ so like, this one's got rules, respect the rules bestie.

💜 Local port Selection 💜

Multiple port/Multiple CA support, aka the "which one of u am I talking to" situation: when no IB device or port is specified (see the "local umad parameters" below 👇), the libibumad library selects the port to use by the following criteria:

1. the first port that is ACTIVE.
2. if not found, the first port that is UP (physical link up).

If a port and/or CA name is specified, the libibumad library attempts to fulfill the user request, and will fail if it is not possible 😭 no negotiating.

For example:

ibaddr                 # use the first port (criteria #1 above)
ibaddr -C mthca1       # pick the best port from "mthca1" only.
ibaddr -P 2            # use the second (active/up) port from the first available IB device.
ibaddr -C mthca0 -P 2  # use the specified port only.

🦋 Configuration flags 🦋

• --config, -z <config_file> — Specify alternate config file. Default: /etc/infiniband-diags/ibdiag.conf
• -t, --timeout <timeout_ms> — override the default timeout for the solicited mads.

🙈 Debugging flags 🙈

• -h, --help — show the usage message
• -d — raise the IB debugging level. May be used several times (-ddd or -d -d -d). stack it like a true queen 👑
• -e — show send and receive errors (timeouts and others)
• -v, --verbose — increase the application verbosity level. May be used several times (-vv or -v -v -v)
• -V, --version — show the version info.

---

🍓 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. 👀 go read it, it's short, it's cute, it explains itself.

---

💖 AUTHOR 💖

Hal Rosenstock < <halr@voltaire.com> > — thank u for ur service, legend 🫶

---

💌 ok that's the whole page bestie!! it's ibping from Open IB Diagnostics, dated 2012-05-14, and honestly? timeless. slay. periodt. 💅✨