Man Linux: Main Page and Category List

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>