IBV_REQ_NOTIFY_CQ(3)

💅 IBV_REQ_NOTIFY_CQ(3) — Libibverbs Programmer’s Manual 💅

okay bestie, welcome to the Libibverbs Programmer’s Manual — today’s main character is ibv_req_notify_cq(3), and she is here to handle your CQ notification business. ✨

---

🌸 NAME 🌸

ibv_req_notify_cq — request completion notification on a completion queue (CQ)

🦋 SYNOPSIS 🦋

#include <infiniband/verbs.h>

int ibv_req_notify_cq(struct ibv_cq *cq, int solicited_only);

🎀 DESCRIPTION 🎀

okay so ibv_req_notify_cq() is literally the function that requests a completion notification on the completion queue (CQ) cq. iconic behavior. 💖

When a new CQ entry (CQE) gets added to cq, a completion event will be added to the completion channel associated with the CQ. That’s the vibe.

Now for the solicited_only tea:

• If solicited_only is zero, a completion event is generated for any new CQE.
• If solicited_only is non-zero, an event is only generated for a new CQE that’s considered “solicited.”

A CQE is solicited if it’s a receive completion for a message with the Solicited Event header bit set, or if the status is not successful. slay that definition. 🌈

All other successful receive completions, or any successful send completion, are unsolicited. no cap. 💅

⭐ RETURN VALUE ⭐

ibv_req_notify_cq() returns 0 on success, or the value of errno on failure (which indicates the failure reason). we love a clear return value. 🫶

🔥 NOTES 🔥

The request for notification is “one shot.” Only one completion event will be generated for each call to ibv_req_notify_cq(). periodt. 💀

🌈 SEE ALSO 🌈

• ibv_create_comp_channel(3)
• ibv_create_cq(3)
• ibv_get_cq_event(3)

👑 AUTHOR 👑

Dotan Barak <dotanba@gmail.com>

---

xoxo, this little gem is from libibverbs, dated 2006-10-31, and it lives under IBV_REQ_NOTIFY_CQ(3). byeee bestie 🫶💖🎀