IBV_XSRQ_PINGPONG(1)

📦 version 65.0, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🦋 NAME 🦋

okay so ibv_xsrq_pingpong — it's a simple InfiniBand shared receive queue test, bestie. that's literally it. section 1 of the manual, USER COMMANDS energy 💅

✨ SYNOPSIS ✨

ibv_xsrq_pingpong [-p port] [-d device] [-i ib port] [-s size] [-m mtu]
[-c clients] [-n num_tests] [-l sl] [-e] [-g gid index] HOSTNAME

ibv_xsrq_pingpong [-p port] [-d device] [-i ib port] [-s size] [-m mtu]
[-c clients] [-n num_tests] [-l sl] [-e] [-g gid index]

two whole moods, fr fr — one where you pass a HOSTNAME, and one where you don't. pick your fighter 💖

🌸 DESCRIPTION 🌸

okay so picture this: you run a simple ping-pong test over InfiniBand, and you do it via the extended reliable connected transport service — that's XRC if you're in the group chat — and it uses a shared receive queue (SRQ). that's the whole vibe. iconic honestly 🎀

💅 OPTIONS 💅

  • -p, --port=PORT — use TCP port PORT for the initial synchronization moment (default 18515). it's giving "let's sync up first" 🫶
  • -d, --ib-dev=DEVICE — use IB device DEVICE (default is the first device found — she's not picky, she'll take whoever shows up first 💀)
  • -i, --ib-port=PORT — use IB port PORT (default port 1)
  • -s, --size=SIZE — ping-pong messages of size SIZE (default 4096)
  • -m, --mtu=MTU — use path mtu of size MTU (default 2048)
  • -c, --clients=CLIENTS — number of clients CLIENTS (this one's on the server only, default 1)
  • -n, --num-tests=NUM_TESTS — perform NUM_TESTS tests per client (default 5)
  • -l, --sl=SL — use SL as the service level value (default 0)
  • -e, --events — sleep while waiting for work completion events (the default is to poll for completions instead). so you're either napping or spinning, no in between 😭
  • -g, --gid-idx=GIDINDEX — local port GIDINDEX. that's it, that's the whole thing ✨

🌈 SEE ALSO 🌈

go read these next, bestie, they're the whole friend group:

👑 AUTHORS 👑

the legends who made this happen:

  • Roland Dreier — <roland@purestorage.com>
  • Jarod Wilson — <jarod@redhat.com>

we stan 💜

💀 BUGS 💀

okay so real talk, this part is not cute. the network synchronization between client and server instances is weak, and it does not prevent incompatible options from being used on the two instances. so like. it will simply not stop you from doing that. 🙈
also the method used for retrieving work completions is not strictly correct, and race conditions may cause failures on some systems. no cap. that's a real caveat, not a vibe — proceed with your eyes open, queen 🔥

and that's the page, bestie!! this whole thing ships as part of libibverbs, dated May 24, 2016 — a certified classic at this point. go forth and ping-pong responsibly 🏓💖

📦 where this page comes from