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/

RPMA                                              01 April 2024                                rpma_conn_wait(3)