NAME

       rpma_conn_next_event - obtain a connection status

SYNOPSIS

             #include <librpma.h>

             struct rpma_conn;
             enum rpma_conn_event {
                     RPMA_CONN_UNDEFINED = -1,
                     RPMA_CONN_ESTABLISHED,
                     RPMA_CONN_CLOSED,
                     RPMA_CONN_LOST,
                     RPMA_CONN_REJECTED,
                     RPMA_CONN_UNREACHABLE
             };

             int rpma_conn_next_event(struct rpma_conn *conn,
                             enum rpma_conn_event *event);

DESCRIPTION

       rpma_conn_next_event() obtains the next event from the connection.  Types of events:

       •  RPMA_CONN_UNDEFINED - undefined connection event

       •  RPMA_CONN_ESTABLISHED - connection established

       •  RPMA_CONN_CLOSED - connection closed

       •  RPMA_CONN_LOST - connection lost

       •  RPMA_CONN_REJECTED - connection rejected

       •  RPMA_CONN_UNREACHABLE - connection unreachable

RETURN VALUE

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

ERRORS

       rpma_conn_next_event() can fail with the following errors:

       •  RPMA_E_INVAL - conn or event is NULL

       •  RPMA_E_UNKNOWN - unexpected event

       •  RPMA_E_PROVIDER - rdma_get_cm_event() or rdma_ack_cm_event() failed

       •  RPMA_E_NOMEM - out of memory

SEE ALSO

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