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>

libibverbs                                         2006-10-31                               IBV_REQ_NOTIFY_CQ(3)