rpma_peer_new(3)

✨ NAME ✨

rpma_peer_new — bestie, we're making a peer object 👑

---

🦋 SYNOPSIS 🦋

#include <librpma.h>

struct ibv_context;
struct rpma_peer;
int rpma_peer_new(struct ibv_context *ibv_ctx, struct rpma_peer **peer_ptr);

okay so this is the RPMA Programmer's Manual btw, the whole vibe of this page is librpma, keep that in your notes 📝

---

💖 DESCRIPTION 💖

rpma_peer_new() creates a new peer object.

That's it. That's the whole thing. It makes the peer. Main character behavior, honestly ✨

---

🌸 RETURN VALUE 🌸

rpma_peer_new() returns 0 on success, or a negative error code if it flops 😭

And hear me on this one: on failure, rpma_peer_new() does not set the *peer_ptr value. Like, it just leaves it alone. No half-finished handoffs, periodt 💅

---

🔥 ERRORS 🔥

rpma_peer_new() can fail with the following errors, bestie — memorize these, they will show up on the quiz:

• RPMA_E_INVAL — ibv_ctx or peer_ptr is NULL. You handed it nothing. It said no 🙈
• RPMA_E_NOMEM — creating a verbs protection domain failed with ENOMEM.
• RPMA_E_PROVIDER — creating a verbs protection domain failed with an error other than ENOMEM.
• RPMA_E_UNKNOWN — creating a verbs protection domain failed without an error value. The void. The mystery. 💀
• RPMA_E_NOMEM — out of memory. (Yes, it's listed twice — one's about the verbs protection domain, one's just the general out-of-memory situation. Both are real, both can happen, don't @ me.)

---

🎀 SEE ALSO 🎀

• rpma_conn_req_new(3)
• rpma_ep_listen(3)
• rpma_mr_reg(3)
• rpma_peer_delete(3)
• rpma_utils_get_ibv_context(3)
• librpma(7)
• https://pmem.io/rpma/

---

k that's the whole page, go be iconic with it 🫶

this has been RPMA, dated 01 April 2024, from the rpma_peer_new(3) girlies for the rpma_peer_new(3) girlies 🌈⭐🧚