IBV_REQ_NOTIFY_CQ(3) Libibverbs Programmer's Manual IBV_REQ_NOTIFY_CQ(3)NAMEibv_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);
DESCRIPTIONibv_req_notify_cq() requests a completion notification on the comple‐
tion 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 success‐
ful receive completions, or any successful send completion is unso‐
licited.
RETURN VALUEibv_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 ALSOibv_create_comp_channel(3), ibv_create_cq(3), ibv_get_cq_event(3)AUTHORS
Dotan Barak <dotanba@gmail.com>
libibverbs 2006-10-31 IBV_REQ_NOTIFY_CQ(3)