RPMA_SRQ_CFG_SET_RCQ_SIZE(3)

📦
version 1.3.0 · 3 versions
, in ubuntu noble

✨ rpma_srq_cfg_set_rcq_size ✨

okay bestie, welcome to the RPMA Programmer's Manual 💖 this one's from section 3 (the library calls girlies), and it's literally just about telling your shared RQ how big its receive CQ should be. no cap. 🎀

🌸 NAME 🌸

rpma_srq_cfg_set_rcq_size — set receive CQ size of the shared RQ

like... that's the whole vibe. you're setting the rcq size. iconic. 💅

🦋 SYNOPSIS 🦋

#include <librpma.h>

struct rpma_srq_cfg;
int rpma_srq_cfg_set_rcq_size(struct rpma_srq_cfg *cfg, uint32_t rcq_size);

so you include <librpma.h>, there's an opaque struct rpma_srq_cfg doing its mysterious main character thing 🫶, and then the function itself takes a cfg pointer and a uint32_t rcq_size. that's it. that's the whole signature. slay.

💜 DESCRIPTION 💜

rpma_srq_cfg_set_rcq_size() sets the receive CQ size of the shared RQ. periodt. ✨

here's the tea though — if you never call this function, the rcq_size just chills at its default value of 100, which was set by rpma_srq_cfg_new(3). so like, no pressure, but also now you know. 🌸

⚠️ important little plot twist: rpma_srq_new(3) does not create its own receive CQ if the size of the receive CQ equals 0. so if you set it to zero, bestie, there is no receive CQ. that's a real thing that happens. 🙈

💖 RETURN VALUE 💖

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

that's it. simple. clean. very demure.

🔥 ERRORS 🔥

rpma_srq_cfg_set_rcq_size() can fail with the following error:

  • RPMA_E_INVAL — cfg is NULL 💀 (yeah, you gotta actually pass a config, bestie)

🧚 SEE ALSO 🧚

go read those too, iykyk 🌈

and that's the page!! this was RPMA, dated 01 April 2024 💜 stay hydrated, pass a non-NULL cfg, and remember the default is 100 unless you say otherwise. mwah. 🫶✨

📦 where this page comes from