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

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  gener-
       ated  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>

libibverbs							    2006-10-31						      IBV_REQ_NOTIFY_CQ(3)