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_cq(3),
ibv_get_cq_event(3)
AUTHORS¶
- Dotan Barak <dotanba@gmail.com>