RPMA_CONN_CFG_GET_CQ_SIZE(3)

📦
version 1.3.0 · 3 versions
, in ubuntu noble

💖 rpma_conn_cfg_get_cq_size — get CQ size for the connection 💖

okay bestie, sit down, hydrate, and let me tell you about the librpma function that goes and fetches the CQ size your connection config is holding onto. it's giving little messenger, not main character, but we love her anyway 🫶

this one lives in the RPMA Programmer's Manual, so you already know it's fancy. iykyk 💅

✨ SYNOPSIS ✨

#include <librpma.h>

struct rpma_conn_cfg;
int rpma_conn_cfg_get_cq_size(const struct rpma_conn_cfg *cfg, uint32_t *cq_size);

literally just those two lines, no more no less, copy them exactly or the compiler will simply not hear you 🙈

🌸 DESCRIPTION 🌸

so rpma_conn_cfg_get_cq_size() gets the CQ size for the connection. that's it. that's the whole job. she's a getter, she gets, she serves 💅

you hand her a cfg, she hands you back the CQ size. no cap.

⭐ RETURN VALUE ⭐

rpma_conn_cfg_get_cq_size() returns 0 on success — slay — or a negative error code on failure 😭

and listen, this part matters: on failure, rpma_conn_cfg_get_cq_size() does not set the *cq_size value. like, she leaves it alone. doesn't touch it. periodt. so don't go reading it expecting a fresh number, bestie, that's not the vibe 🚫

💀 ERRORS 💀

rpma_conn_cfg_get_cq_size() can fail with the following error:

  • RPMA_E_INVAL — cfg or cq_size is NULL. yeahhh, if you passed her nothing (or a pointer to nothing), she's gonna be like "ma'am, i can't work with this" 🫠

🦋 SEE ALSO 🦋

and that's the whole page, bestie 💖 if you got this far you're officially obsessed with RDMA and honestly, valid. go forth and get that CQ size 👑

RPMA — 01 April 2024 — rpma_conn_...get_cq_size(3) 🎀 mwah, xoxo, stay documented ✨

📦 where this page comes from