NAME¶
rpma_conn_next_event - obtain a connection status
SYNOPSIS¶
#include <librpma.h>
struct rpma_conn;
enum rpma_conn_event {
RPMA_CONN_UNDEFINED = -1,¶
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
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