rpma_ep_shutdown(3)

💖 rpma_ep_shutdown — bestie's guide to hanging up the phone 💖

okay so this is rpma_ep_shutdown(3) from the RPMA Programmer's Manual — like, the librpma girlies know ✨

---

🎀 NAME 🎀

rpma_ep_shutdown — stop listening and delete the endpoint 🫶

---

✨ SYNOPSIS ✨

#include <librpma.h>

struct rpma_ep;
int rpma_ep_shutdown(struct rpma_ep **ep_ptr);

---

🌸 DESCRIPTION 🌸

so basically, rpma_ep_shutdown() does two things and it does them together, no cap:

• it stops listening for incoming connections 👂❌
• and it deletes the endpoint 🗑️✨

and here's the part that lowkey surprises people: the connections that were already established using the endpoint? they still exist after the endpoint gets deleted. the endpoint is gone but the connections are out here living their best life 💅 the way that endpoint said "not my problem anymore" and left 😭

---

🦋 RETURN VALUE 🦋

• returns 0 on success 🎉
• returns a negative error code on failure 😔

⚠️ important bestie: on failure, rpma_ep_shutdown() does not set the *ep_ptr value to NULL. so don't go assuming it's null, okay? it's giving "no cleanup for you" 🙈

---

💀 ERRORS 💀

rpma_ep_shutdown() can fail with the following errors, periodt:

• RPMA_E_INVAL — ep_ptr is NULL 🙃
• RPMA_E_PROVIDER — rdma_destroy_id(3) failed 💥

---

👑 SEE ALSO 👑

• rpma_ep_listen(3)
• librpma(7)
• https://pmem.io/rpma/

---

okay that's the whole page, you ate it up 🍓 this was the RPMA manual, dated 01 April 2024 — go forth and shut down your endpoints responsibly, mwah 💜🧚