NAME

rpma_cq_wait - wait for a completion and ack it

SYNOPSIS

      #include <librpma.h>
      struct rpma_cq;
      int rpma_cq_wait(struct rpma_cq *cq);

DESCRIPTION

rpma_cq_wait() waits for an incoming completion event and acks it. If rpma_cq_wait() succeeds, then all available completions should be collected using rpma_cq_get_wc(3) before the next rpma_cq_wait() call.

RETURN VALUE

The rpma_cq_wait() function returns 0 on success or a negative error code on failure.

ERRORS

rpma_cq_wait() can fail with the following errors:

• RPMA_E_INVAL - cq is NULL
• RPMA_E_PROVIDER - ibv_req_notify_cq(3) failed with a provider error
• RPMA_E_NO_COMPLETION - no completions available
• RPMA_E_SHARED_CHANNEL - the completion event channel is shared and cannot be handled by any particular CQ

SEE ALSO

rpma_conn_get_cq(3), rpma_conn_get_rcq(3), rpma_cq_get_wc(3), rpma_cq_get_fd(3), librpma(7) and https://pmem.io/rpma/