IBV_RESIZE_CQ(3)

💅 IBV_RESIZE_CQ(3) — the Libibverbs Programmer's Manual, but make it cute

okay bestie, buckle up 🎀 this one is from the Libibverbs Programmer's Manual and it's literally all about giving your completion queue a glow-up. Yes, a CQ. We're resizing it. Slay.

---

✨ NAME ✨

ibv_resize_cq — resize a completion queue (CQ) 💖

---

🦋 SYNOPSIS 🦋

#include <infiniband/verbs.h>

int ibv_resize_cq(struct ibv_cq *cq, int cqe);

---

🌸 DESCRIPTION 🌸

so ibv_resize_cq() resizes the completion queue (CQ) cq so it has at least cqe entries. that's the whole vibe. ✨

now the important part, no cap: cqe must be at least the number of unpolled entries in the CQ cq. like, you cannot shrink below the stuff that hasn't been polled yet, that's a whole mess we're not doing 🙈

and if cqe is a valid value that's less than the current CQ size, ibv_resize_cq() may not do anything — because this function is only guaranteed to resize the CQ to a size at least as big as the requested size. lowkey funny but that's the deal, iykyk 💅

---

🔥 RETURN VALUE 🔥

ibv_resize_cq() returns 0 on success, or the value of errno on failure (which indicates the failure reason). periodt. 💀

---

👑 NOTES 👑

heads up bestie — ibv_resize_cq() may assign a CQ size greater than or equal to the requested size. it's giving generous ✨ and the cqe member of cq will be updated to the actual size. so like, always go check cqe after, don't assume, fr fr 🫶

---

🌈 SEE ALSO 🌈

• ibv_create_cq(3)
• ibv_destroy_cq(3)

go read those too, they're iconic in their own right 💜

---

🧚 AUTHOR 🧚

Dotan Barak <dotanba@gmail.com> — thank you legend, we stan 🌟

---

and that's the whole page, bestie! 💖 this one ships out with libibverbs, dated 2006-10-31, and the man page tag is IBV_RESIZE_CQ(3). now go resize that queue and be the main character of your own verbs program 🎀🌟💅