RDMA_DESTROY_ID(3)

✨ RDMA_DESTROY_ID ✨ (section 3 of the librdmacm programmer's manual, bestie)

okay so. this is the one where you say bye-bye to a communication identifier 🫶 it's rdma_destroy_id, and it lives in section 3, and honestly? it's giving closure. 💅

🌸 SYNOPSIS 🌸

#include <rdma/rdma_cma.h>

int rdma_destroy_id (struct rdma_cm_id *id);

like. two lines. that's the whole vibe. 😭

🎀 ARGUMENTS 🎀

• id — the communication identifier you're about to send to the shadow realm 💀 the one you wanna destroy.

🦋 DESCRIPTION 🦋

So here's the tea: rdma_destroy_id destroys the rdma_cm_id you hand it, and it cancels any outstanding asynchronous operation. yes, both. it's a two-for-one. slay. ✨

not me thinking that's efficient… it IS efficient. periodt.

⭐ RETURN VALUE ⭐

• 0 — success, we ate, everything's fine 💖
• -1 — error 😭 and if that happens, errno gets set to tell you why it flopped.

👑 NOTES 👑

bestie, listen, this part is IMPORTANT 🙈

Before you call this routine, you must:

• free any associated QP with the rdma_cm_id, and
• ack all related events.

no skipping. no "i'll do it later". the routine is not gonna do it for you. 💅

🌈 SEE ALSO 🌈

• rdma_create_id(3)
• rdma_destroy_qp(3)
• rdma_ack_cm_event(3)

iykyk — go read those too, they're all part of the same little friend group 🧚

and that's the whole page, angel 💜 this one's from the librdmacm crew, dated 2010-07-19 — old but iconic, like a vintage bag that still goes with everything 🎀 mwah, go destroy some ids responsibly 🫶