dapl-testsrq(1)

💅 dapl-testsrq — like, the SRQ edition 🎀

okay so bestie, welcome to dapl-testsrq(1), a USER COMMAND and honestly? it's giving "let's actually make sure this uDAPL thing works" energy ✨

---

✨ NAME ✨

dapl-testsrq — a simple uDAPL send/receive and RDMA test that uses a shared receive queue (aka SRQ, aka the whole point 💅)

---

🌸 SYNOPSIS 🌸

dapl-testsrq [-vu] [-P provider] [-b buf size] [-B burst size] [-t burst
num] [-c connections] [-p port] [-S 0|1] [ -s | -h HOSTNAME ]

---

🦋 DESCRIPTION 🦋

So dapl-testsrq is this simple little test that exists to exercise and verify the uDAPL interfaces. Cute, right? But here's the thing — you can't just run it alone, no ma'am. You need at least two instantiations of the test running. One is the server, the other is the client. iconic duo behavior fr fr 🫶

The server side, once you invoke it, sits there and listens for connection requests — until it times out or someone kills it 😭 (rip). The moment a cd connection request shows up, the connection gets established, and then the server side and client side exchange all the info they need to do RDMA writes and reads.

And the main character detail? 💫 This test supports SRQ, so literally all the connections share the same Rx Q. not me being obsessed with shared receive queues 🌈

---

💖 OPTIONS 💖

• -P=PROVIDER — use PROVIDER to specify the uDAPL interface via /etc/dat.conf (default ofa-v2-ib0) ⭐
• -h=HOSTNAME — use HOSTNAME to specify the server hostname or IP address (default — none) 🎀
• -b=BUFFER_SIZE — use buffer size BUFFER_SIZE for RDMA (default 64) 🍓
• -B=BURST_SIZE — use burst size BURST_SIZE (default 1) ✨
• -t=BURST_COUNT — use burst count BURST_COUNT (default 3) 💫
• -p=PORT_NUM — use port PORT_NUM (default 45248) 🔥
• -c=CONN_NUM — establish CONN_NUM connections (default = 1, max = 100) 👑
• -s — run as server (default — run as server) 💅
• -S — use SRQ (default use SQR) 🧚
• -v — verbose output (default off) 🙈
• -u — run ud test (default no) 💜
• -l=LID — use LID for server lid in ucm provider (default — none) 🌸
• -q=QPN — use QPN for server qpn in ucm provider (default — none) 🦋

---

🌟 EXAMPLES 🌟

k so here's how you actually run this thing 👇

dapl-testsrq -P ofa-v2-ib0 -s -c 10

Starts a server process with 10 connections using provider ofa-v2-ib0. slay 💅

dapl-testsrq -P ofa-v2-ib0 -c 10 -h server1-ib0

Starts a client process with 10 connections, using the ofa-v2-ib0 provider to connect to hostname server1-ib0. periodt ✨

---

👀 SEE ALSO 👀

dapl-utest(1), dapl-testx(1), dapl-testcm(1), dapl-test(1) — go read the whole friend group 🫶

---

💜 AUTHORS 💜

• Arlin Davis — <arlin.r.davis@intel.com>
• Amir Hanania — <amir.hanania@intel.com>

---

ngl bestie, if something's acting cursed, remember: two instances minimum, or this test is literally just gonna sit there listening forever 😭

---

kisses and SRQs 💋 — this was brought to you by uDAPL 2.1, dated November 15, 2016 🎀✨