RDMA_LEAVE_MULTICAST(3)

💅 rdma_leave_multicast — bestie, we're LEAVING 💅

okay so this is rdma_leave_multicast(3) from the Librdmacm Programmer's Manual, and it's giving "exit the group chat, gracefully, with your head held high" energy. no cap.

🌸 NAME 🌸

rdma_leave_multicast — leaves a multicast group. that's it. that's the whole vibe. say bye bestie 👋

✨ SYNOPSIS ✨

#include <rdma/rdma_cma.h>

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

two args, one exit, zero drama (hopefully).

🎀 ARGUMENTS 🎀

• id — the communication identifier that's associated with the request. it's the lil handle that knows who you are and what you're up to 🫶
• addr — the multicast address that identifies the group you're about to leave. yeah, you gotta name names. we're pointing at the group and going "not you anymore" 💀

🦋 DESCRIPTION 🦋

so what does it actually do? it leaves a multicast group, and it detaches an associated QP from that group. that's the whole thing. you were in, now you're out, and your QP is coming with you. main character exit, honestly 👑

⭐ RETURN VALUE ⭐

• returns 0 on success 🎉 — slay, you left
• returns -1 on error 😭 — and if that happens, errno gets set to indicate the failure reason, so go read it, it's literally telling you what went wrong

💜 NOTES 💜

• calling this function before a group has been fully joined? that results in canceling the join operation. so it's not a no-op, it's a "never mind, actually" 🙈
• important, listen up: users should be aware that messages received from the multicast group may still be queued for completion processing immediately after leaving a multicast group. so like… you left the party but your texts are still arriving. don't be surprised, bestie 🔥
• destroying an rdma_cm_id will automatically leave all multicast groups. so if you're feeling lazy, that's your cleanup era ✨

🌈 SEE ALSO 🌈

• rdma_join_multicast(3) — the other half of this situationship
• rdma_destroy_qp(3) — when you need the QP gone gone

that's the whole page, you ate it, periodt 💅✨

sign-off szn: this was librdmacm, dated 2007-05-15, and the page is RDMA_LEAVE_MULTICAST(3) — mwah, go leave a multicast group responsibly 🎀🦋💖