.\" Extracted by src2man from /build/rpma-11eW7Q/rpma-1.3.0/src/include/librpma.h
.\" Text automatically generated by txt2man
.TH rpma_conn_req_recv 3 "29 May 2023" "RPMA" "RPMA Programmer's Manual"
.SH NAME
\fBrpma_conn_req_recv \fP- initiate the receive operation
.SH SYNOPSIS
.nf
.fam C
      #include <librpma.h>

      struct rpma_conn_req;
      struct rpma_mr_local;
      int \fBrpma_conn_req_recv\fP(struct rpma_conn_req *req, struct rpma_mr_local *dst, size_t offset,
                      size_t len, const void *op_context);

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBrpma_conn_req_recv\fP() initiates the receive operation. It prepares a buffer for a message sent
from other side of the connection. Please see \fBrpma_send\fP(3). This is a variant of \fBrpma_recv\fP(3)
which may be used before the connection is established. op_context is returned in the wr_id
field of the completion (struct ibv_wc).
.SH RETURN VALUE
The \fBrpma_conn_req_recv\fP() function returns 0 on success or a negative error code on failure.
.SH ERRORS
\fBrpma_conn_req_recv\fP() can fail with the following errors:
.IP \(bu 3
RPMA_E_INVAL - req or src or op_context is NULL
.IP \(bu 3
RPMA_E_PROVIDER - \fBibv_post_recv\fP(3) failed
.SH SEE ALSO
\fBrpma_conn_req_new\fP(3), \fBrpma_mr_reg\fP(3), \fBlibrpma\fP(7) and https://pmem.io/rpma/