rpma_conn_delete(3)

📦
version 1.3.0 · 3 versions
, in ubuntu noble

💖 rpma_conn_delete(3) — the RPMA Programmer's Manual, bestie edition 💖

okay so you're deep in the librpma lore (that's the RPMA library manual, section 3, iykyk) and you need to yeet a connection that's already been closed. not me writing a whole page about the cleanest little goodbye ever 💅

✨ NAME ✨

rpma_conn_delete — delete already closed connection

like. the connection is already closed. you're just here to do the final cleanup. the closing ceremony. the confetti cleanup crew. 🎀

🌸 SYNOPSIS 🌸

#include <librpma.h>

struct rpma_conn;
int rpma_conn_delete(struct rpma_conn **conn_ptr);

🦋 DESCRIPTION 🦋

rpma_conn_delete() deletes an already closed connection.

that's it. that's the whole vibe. it's giving "you already said your goodbyes, now take out the trash" 🗑️✨

real talk though: the connection has to be already closed first. this is the after-party cleanup, not the breakup itself. bestie please read that twice 🫶

👑 RETURN VALUE 👑

rpma_conn_delete() returns 0 on success, or a negative error code on failure.

and here's the iconic part — on success AND on failure, rpma_conn_delete() sets the *conn_ptr value to NULL. so either way, that pointer is getting set to NULL. no cap. it's the one consistent queen in your life 💅

🔥 ERRORS 🔥

rpma_conn_delete() can fail with these errors, so pay attention:

  • RPMA_E_INVAL — conn_ptr is NULL, or munmap() failed 😭
  • RPMA_E_PROVIDER — ibv_destroy_cq() or rdma_destroy_id() failed 💀

🌈 SEE ALSO 🌈

and that's the whole page, bestie — go forth and delete responsibly 🧚💜

this was RPMA Programmer's Manual energy, dated 01 April 2024 — mwah, slay, periodt ✨🍓

📦 where this page comes from