RDMA_XCLIENT(1)

💖 RDMA_XCLIENT 💖

okay bestie so this is a page from the librdmacm manual, and it's about rdma_xclient — a whole little test program for talking RDMA. let's get into it 🫶

✨ NAME ✨

rdma_xclient — the RDMA CM communication client test program, aka the little buddy that calls up the server 💅

🌸 SYNOPSIS 🌸

rdma_xclient [-s server_address] [-p server_port] [-c comm_type]

🦋 DESCRIPTION 🦋

So what's the vibe? This thing uses synchronous librdmam calls to set up an RDMA connection between two nodes. that's it, that's the whole job ✨

and like, the point of it? it's meant to be a super simple coding example of how to use RDMA. a starter pack, a beginner-friendly little guy, a tutorial you can actually run. no cap 🎀

💅 OPTIONS 💅

• -s server_address — tells it the address of the system that the rdma_server is running on. and if you just... don't say anything? the client will try to connect to the server using 127.0.0.1 by default. localhost bestie behavior 🙈
• -p server_port — the port number the server listens on. default? the server listens on port 7471. iconic number, don't forget it 💜
• -c communication type — picks what kind of communication gets established with the server program:
  • 'r' → uses a reliable-connected QP. and yes, this is the default 💖
  • 'x' → uses extended reliable-connected XRC QPs 🔥

🌈 NOTES 🌈

Basic usage is literally: start up rdma_xserver, then connect to the server using the rdma_client program. that's the whole loop, go off 👑

⚠️ real talk though — because this test maps RDMA resources to userspace, users must make sure they have available system resources and permissions. it will not be cute if you skip this. check the libibverbs README file for all the additional details, fr fr 😭

👑 SEE ALSO 👑

• rdma_cm(7)
• udaddy(1)
• mckey(1)
• rping(1)
• rdma_xserver(1)
• rdma_client(1)

and that's the page!! brought to you by librdmacm, dated 2011-06-15 — yes she's an elder but she still slays ⭐ mwah, go connect some nodes bestie 💖🌸🦋