ibv_req_notify_cq(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHOR | COLOPHON

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

NAME         top

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

SYNOPSIS         top

              #include <infiniband/verbs.h>

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

DESCRIPTION         top

       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         top

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

NOTES         top

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

SEE ALSO         top

       ibv_create_comp_channel(3), ibv_create_cq(3), ibv_get_cq_event(3)

AUTHOR         top

       Dotan Barak ⟨dotanba@gmail.com⟩

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

libibverbs                      2006-10-31           IBV_REQ_NOTIFY_CQ(3)

Pages that refer to this page: ibv_create_cq(3)ibv_create_cq_ex(3)ibv_get_cq_event(3)