RDMA_BIND_ADDR(3)

💖 RDMA_BIND_ADDR 💖

okay bestie, welcome to the Librdmacm Programmer's Manual ✨ this is rdma_bind_addr, and yes she's a 3-section girlie (that means library function, iykyk). let's get into it 🎀

✨ NAME ✨

rdma_bind_addr — bind an RDMA identifier to a source address 🦋

🌸 SYNOPSIS 🌸

#include <rdma/rdma_cma.h>

int rdma_bind_addr (struct rdma_cm_id *id, struct sockaddr *addr);

💅 ARGUMENTS 💅

• id — the RDMA identifier, your main character 🫶
• addr — local address info. wildcard values are permitted, she's flexible like that 💁♀️

👑 DESCRIPTION 👑

so basically this associates a source address with an rdma_cm_id. the address may be wildcarded — no cap. and if you're binding to a specific local address, the rdma_cm_id will also get bound to a local RDMA device. two things at once, she's multitasking, we love to see it ✨

🍓 RETURN VALUE 🍓

• returns 0 on success 💖
• returns -1 on error 😭
• and if an error happens, errno gets set to tell you the failure reason. she will always tell you what went wrong, communication queen 💅

🌈 NOTES 🌈

typically, you call this routine before calling rdma_listen to bind to a specific port number. but it may also be called on the active side of a connection before calling rdma_resolve_addr to bind to a specific address. so like, either vibe works depending on what you're doing 🦋

if you use it to bind to port 0, the rdma_cm will select an available port for you — and you can retrieve it with rdma_get_src_port(3). free port, no effort, we love an assist 🫶

🎀 SEE ALSO 🎀

• rdma_create_id(3)
• rdma_listen(3)
• rdma_resolve_addr(3)
• rdma_create_qp(3)
• rdma_get_local_addr(3)
• rdma_get_src_port(3)

and that's the whole page, bestie — no crumbs left 💜 this came to you from librdmacm, dated 2007-05-15, under the header RDMA_BIND_ADDR(3). she's been iconic since '07 and she's still serving ⭐ go bind something and slay 👑💖