RPMA_CONN_CFG_SET_SQ_SIZE(3)

💖 rpma_conn_cfg_set_sq_size(3) 💖

okay bestie, so this is a page from the RPMA Programmer's Manual (yes, the RPMA one, we love her) and it's literally just about one tiny little function that sets one tiny little number. but that number MATTERS, so let's get into it 🫶

---

✨ NAME ✨

rpma_conn_cfg_set_sq_size — set the SQ size for the connection

like. that's it. that's the whole job. she sets the SQ size. queen behavior honestly 👑

---

🌸 SYNOPSIS 🌸

#include <librpma.h>

struct rpma_conn_cfg;
int rpma_conn_cfg_set_sq_size(struct rpma_conn_cfg *cfg, uint32_t sq_size);

okay so you're pulling in <librpma.h>, there's this opaque struct rpma_conn_cfg situation going on, and then the function itself takes a pointer to that config (cfg) plus a uint32_t called sq_size, and hands you back an int. slay 💅

---

🦋 DESCRIPTION 🦋

rpma_conn_cfg_set_sq_size() sets the SQ size for the connection. that's the whole vibe, no cap.

and here's the lil detail that matters: if you never call this function, the sq_size just chills at its default value of 10, which was set for you by rpma_conn_cfg_new(3). so like, the config comes pre-loaded with a 10 and you're just here to change it if you want. iconic default behavior tbh 🌈

---

⭐ RETURN VALUE ⭐

the rpma_conn_cfg_set_sq_size() function returns 0 on success, or a negative error code on failure.

zero = we ate. negative = something went wrong, bestie 😭

---

🎀 ERRORS 🎀

rpma_conn_cfg_set_sq_size() can fail with the following error:

• RPMA_E_INVAL — cfg is NULL

fr fr, if you pass a NULL cfg she is NOT going to be chill about it. always pass a real config, okay? 💀

---

💜 SEE ALSO 💜

• rpma_conn_cfg_new(3)
• rpma_conn_cfg_get_sq_size(3)
• librpma(7)
• <https://pmem.io/rpma/>

---

and that's the whole page, bestie!! this masterpiece is brought to you by RPMA, dated 01 April 2024 — go forth and set your SQ sizes responsibly 🧚💖✨