---
name: "ibv_req_notify_cq"
section: "3"
platform: "linux"
package: "rdma-core"
version: "65.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/ibv_req_notify_cq"
---

# ibv\_req\_notify\_cq(3)

request completion notification on a completion queue (CQ)

## 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

**ibv\_req\_notify\_cq()** requests a completion notification on the completion queue (CQ) *cq*.

Upon the addition of a new CQ entry (CQE) to *cq*, a completion event will be added to the completion channel associated with the CQ. If the argument *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 with that is considered “solicited.” A CQE is solicited if it is a receive completion for a message with the Solicited Event header bit set, or if the status is not successful. All other successful receive completions, or any successful send completion is unsolicited.

## RETURN VALUE

**ibv\_req\_notify\_cq()** returns 0 on success, or the value of errno on failure (which indicates the failure reason).

## NOTES

The request for notification is “one shot.” Only one completion event will be generated for each call to **ibv\_req\_notify\_cq()**.

## SEE ALSO

[**ibv\_create\_comp\_channel**(3)](/ibv_create_comp_channel/3.md), [**ibv\_create\_cq**(3)](/ibv_create_cq/3.md), [**ibv\_get\_cq\_event**(3)](/ibv_get_cq_event/3.md)

## AUTHOR

Dotan Barak ⟨dotanba@gmail.com⟩\\c