ibv_req_notify_cq
Requests the completion notification on a completion queue (CQ).
Syntax
#include <rdma/verbs.h>
int ibv_req_notify_cq(struct ibv_cq *cq, int solicited_only);Description
The ibv_req_notify_cq() function requests a completion notification on the completion queue (CQ) cq parameter.
When a new CQ entry (CQE) is added to a cq parameter, a completion event is added to the completion channel that is associated with the CQ. If the solicited_only argument is zero, a completion event is generated for any new CQE. If solicited_only parameter is nonzero, an event is generated for a new CQE that is considered solicited. A CQE is solicited if it receives completion for a message that has 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.
Note: The request for a notification is sent once.
One completion event is generated for each call that is made to the ibv_req_notify_cq() function.
Parameters
| Item | Descriptor |
|---|---|
| cq | Specifies the ibv_cq struct
for the ibv_create_cq function. |
| solicited_only | Notifies only if the WR is flagged as solicited. |
Return Values
| Item | Descriptor |
|---|---|
| 0 | On success. |
| errno | On failure. |