1IBV_REQ_NOTIFY_CQ(3)    Libibverbs Programmer's Manual    IBV_REQ_NOTIFY_CQ(3)
2
3
4

NAME

6       ibv_req_notify_cq  -  request  completion  notification on a completion
7       queue (CQ)
8

SYNOPSIS

10       #include <infiniband/verbs.h>
11
12       int ibv_req_notify_cq(struct ibv_cq *cq, int solicited_only);
13

DESCRIPTION

15       ibv_req_notify_cq() requests a completion notification on  the  comple‐
16       tion queue (CQ) cq.
17
18       Upon  the  addition  of  a new CQ entry (CQE) to cq, a completion event
19       will be added to the completion channel associated with the CQ.  If the
20       argument  solicited_only  is  zero, a completion event is generated for
21       any new CQE.  If solicited_only is non-zero, an event is only generated
22       for  a new CQE with that is considered "solicited."  A CQE is solicited
23       if it is a receive completion for a message with  the  Solicited  Event
24       header bit set, or if the status is not successful.  All other success‐
25       ful receive completions, or any successful  send  completion  is  unso‐
26       licited.
27

RETURN VALUE

29       ibv_req_notify_cq()  returns  0  on  success,  or the value of errno on
30       failure (which indicates the failure reason).
31

NOTES

33       The request for notification is "one shot."  Only one completion  event
34       will be generated for each call to ibv_req_notify_cq().
35

SEE ALSO

37       ibv_create_comp_channel(3), ibv_create_cq(3), ibv_get_cq_event(3)
38

AUTHORS

40       Dotan Barak <dotanb@mellanox.co.il>
41
42
43
44libibverbs                        2006-10-31              IBV_REQ_NOTIFY_CQ(3)
Impressum