.\" Extracted by src2man from /build/rpma-11eW7Q/rpma-1.3.0/src/include/librpma.h
.\" Text automatically generated by txt2man
.TH rpma_ep_next_conn_req 3 "29 May 2023" "RPMA" "RPMA Programmer's Manual"
.SH NAME
\fBrpma_ep_next_conn_req \fP- obtain an incoming connection request
.SH SYNOPSIS
.nf
.fam C
      #include <librpma.h>

      struct rpma_ep;
      struct rpma_conn_cfg;
      struct rpma_conn_req;
      int \fBrpma_ep_next_conn_req\fP(struct rpma_ep *ep, const struct rpma_conn_cfg *cfg,
                      struct rpma_conn_req **req_ptr);

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBrpma_ep_next_conn_req\fP() obtains the next connection request from the endpoint.
.SH RETURN VALUE
The \fBrpma_ep_next_conn_req\fP() function returns 0 on success or a negative error code on failure.
\fBrpma_ep_next_conn_req\fP() does not set *req_ptr value on failure.
.SH ERRORS
\fBrpma_ep_next_conn_req\fP() can fail with the following errors:
.IP \(bu 3
RPMA_E_INVAL - ep or req_ptr is NULL
.IP \(bu 3
RPMA_E_INVAL - obtained an event different than a connection request
.IP \(bu 3
RPMA_E_PROVIDER - \fBrdma_get_cm_event\fP(3) failed
.IP \(bu 3
RPMA_E_NOMEM - out of memory
.IP \(bu 3
RPMA_E_NO_EVENT - no next connection request available
.SH SEE ALSO
\fBrpma_conn_cfg_new\fP(3), \fBrpma_conn_req_delete\fP(3), \fBrpma_conn_req_connect\fP(3), \fBrpma_ep_listen\fP(3),
\fBlibrpma\fP(7) and https://pmem.io/rpma/