NAME

       rpma_conn_wait  -  wait for a completion event on the shared completion channel from CQ or
       RCQ

SYNOPSIS

             #include <librpma.h>

             struct rpma_conn;
             struct rpma_cq
             int rpma_conn_wait(struct rpma_conn *conn, int flags, struct rpma_cq **cq, bool *is_rcq)

DESCRIPTION

       rpma_conn_wait() waits for a completion event on the shared completion channel from CQ  or
       RCQ, acks it and returns a CQ that caused the event in the cq argument and a boolean value
       saying if it is  RCQ  or  not  in  the  is_rcq  argument  (if  is_rcq  is  not  NULL).  If
       rpma_conn_wait()  succeeds,  then  all  available completions should be collected from the
       returned cq using rpma_cq_get_wc(3).

RETURN VALUE

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

ERRORS

       rpma_conn_wait() can fail with the following errors:

       •  RPMA_E_INVAL - conn or cq are NULL

       •  RPMA_E_NOT_SHARED_CHNL - the completion event channel is not shared

       •  RPMA_E_NO_COMPLETION - ibv_get_cq_event(3) failed

       •  RPMA_E_UNKNOWN - ibv_get_cq_event(3) returned unknown CQ

       •  RPMA_E_PROVIDER - ibv_req_notify_cq(3) failed

SEE ALSO

       rpma_conn_req_new(3), librpma(7) and https://pmem.io/rpma/