rpma_ep_listen(3)

✨ rpma_ep_listen(3) ✨

the one from the RPMA Programmer's Manual — bestie, you're literally about to build a whole listening era 💅

---

🎀 NAME 🎀

rpma_ep_listen — create a listening endpoint. that's it, that's the vibe. she makes the endpoint, she makes it listen. main character energy fr fr 👑

---

🌸 SYNOPSIS 🌸

#include <librpma.h>

struct rpma_peer;
struct rpma_ep;
int rpma_ep_listen(struct rpma_peer *peer, const char *addr, const char *port,
                struct rpma_ep **ep_ptr);

like. look at her. iconic signature, no notes. ✨

---

🦋 DESCRIPTION 🦋

okay so rpma_ep_listen() does two things and it eats both times:

• it creates an endpoint, and
• it initiates listening for incoming connections

and the communication flavour? reliable, connection-oriented, and message-based — that's RDMA_PS_TCP QP communication, no cap. 🫶

so yeah, she's the one standing at the door being like "hi bestie, come in, we're doing RDMA today." 🚪💖

---

👑 RETURN VALUE 👑

rpma_ep_listen() returns 0 on success, or a negative error code on failure. simple as that.

🚨 important 🚨 — rpma_ep_listen() does not set the *ep_ptr value on failure. so don't go dereferencing that thing hoping for a lil endpoint surprise, because there isn't one. she leaves it alone. periodt.

---

💀 ERRORS 💀

when things go wrong (and they might 😭), rpma_ep_listen() can fail with these:

• RPMA_E_INVAL — peer, addr, port or ep_ptr is NULL. bestie. something is missing. check ur args. 🙈
• RPMA_E_PROVIDER — rdma_create_event_channel(3), rdma_create_id(3), rdma_getaddrinfo(3), rdma_listen(3) failed. one of the provider-side girlies did not come through. 💀
• RPMA_E_NOMEM — out of memory. no ram, no slay. 😭

---

🌈 SEE ALSO 🌈

go read these next, they're all part of the lore, iykyk:

• rpma_ep_get_fd(3)
• rpma_ep_next_conn_req(3)
• rpma_ep_shutdown(3)
• rpma_peer_new(3)
• librpma(7)
• and the link: https://pmem.io/rpma/ ⭐

---

RPMA · 01 April 2024 🎀

and that's the whole page bestie, we ate, no crumbs left, go write ur listening endpoint now 💖✨🦋