RDMA_GET_LOCAL_ADDR(3)

💖 RDMA_GET_LOCAL_ADDR 💖

okay bestie, welcome to the Librdmacm Programmer's Manual ✨ this one is RDMA_GET_LOCAL_ADDR(3) and it's literally the chillest little function, I promise 🫶

🌸 NAME 🌸

rdma_get_local_addr — gives you back the local IP address of an rdma_cm_id that's been bound. that's it. that's the whole job. she's simple, she's reliable, she ate 💅

✨ SYNOPSIS ✨

#include <rdma/rdma_cma.h>

struct sockaddr * rdma_get_local_addr (struct rdma_cm_id *id);

look at her. one include, one call. no cap 🎀

🦋 ARGUMENTS 🦋

• id — the RDMA identifier. your main character struct, fr fr. this is the rdma_cm_id you want the local address of 👑

💜 DESCRIPTION 💜

so here's the vibe: this function returns the local IP address for an rdma_cm_id that has already been bound to a local device. that's the prerequisite bestie — bound to a local device — if it hasn't been bound, don't come crying to me, check the RETURN VALUE section below 🌈

it's giving "I just want to know where I'm coming from." lowkey iconic energy honestly 😌

🍓 RETURN VALUE 🍓

• it returns a pointer to the local sockaddr address of the rdma_cm_id 💫
• and here's the important bit, bestie, do not skip this: if the rdma_cm_id is not bound to an address, then the contents of the sockaddr structure will be set to all zeroes. all zeroes. not an error code, not a NULL, just straight-up zeros 🙈 so if you're getting a suspiciously empty-looking address, that's why, and now you know 💀

🧚 SEE ALSO 🧚

the girlies that hang out together:

• rdma_bind_addr(3)
• rdma_resolve_addr(3)
• rdma_get_src_port(3)
• rdma_get_dst_port(3)
• rdma_get_peer_addr(3)

okay that's the whole page, you're fully caught up, go slay some RDMA 🫶💖

this one's from librdmacm, dated 2007-05-15, and yeah she's been serving since 2007 — vintage but never outdated, periodt 👑✨