rpma_srq_new(3)

💖 rpma_srq_new — bestie's guide to the RPMA Programmer's Manual ✨

okay so. sit down, hydrate, and let's talk about rpma_srq_new(3) from the RPMA Programmer's Manual, because this one is actually so good. it's giving "make me a shared RQ" and honestly? iconic behavior. 🦋

---

🌸 NAME 🌸

rpma_srq_new — create a new shared RQ object 💅

---

✨ SYNOPSIS ✨

no cap, this is the whole vibe:

#include <librpma.h>

struct rpma_peer;
struct rpma_srq_cfg;
struct rpma_srq;
int rpma_srq_new(struct rpma_peer *peer, const struct rpma_srq_cfg *cfg,
                struct rpma_srq **srq_ptr);

like. look at it. peer, cfg, srq_ptr. three little besties. 🫶

---

🎀 DESCRIPTION 🎀

okay so rpma_srq_new() creates a new shared RQ object, and bestie, that object is not coming alone — it comes with a brand new shared RQ AND a brand new shared receive CQ. package deal. main character energy, fr fr. 👑

but here's the tea: it does NOT create the shared receive CQ if the size of the receive CQ in cfg equals 0. so if you pass a zero size, no CQ for you, that's just the rules. 💀

---

🌈 RETURN VALUE 🌈

rpma_srq_new() returns 0 on success, or a negative error code on failure. slay when it's 0, sad when it's negative. 😭

also important: on failure, rpma_srq_new() does not set the *srq_ptr value. so don't go reading it, bestie, it's not gonna have anything for you. 🙈

and if cfg is NULL? then the default values are used. easy peasy. 🍓

• see rpma_srq_cfg_new(3) for more details. (iykyk, go read it, it's got the lore.) 📖

---

💜 ERRORS 💜

rpma_srq_new() can fail with the following errors, and we respect all of them:

• RPMA_E_INVAL — peer or srq_ptr is NULL. yeah, you gotta give it something. not me passing NULL... 💀
• RPMA_E_NOMEM — out of memory. the tragedy. the absolute heartbreak. 😭
• RPMA_E_PROVIDER — ibv_create_srq(3), ibv_create_comp_channel(3), ibv_create_cq(3) or ibv_req_notify_cq(3) failed. one of the provider besties said no. 🔥

---

🧚 SEE ALSO 🧚

• rpma_srq_delete(3)
• rpma_srq_get_rcq(3)
• librpma(7)
• https://pmem.io/rpma/ — go, click, absorb, thrive ✨

---

lowkey reminder: this whole page is from the RPMA manual, dated 01 April 2024. that's the version, that's the date, and that's the whole entire thing. periodt. 💅👑

bye bestie, go make some shared RQs 🦋🌸💖