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

      struct rpma_conn;
      struct rpma_cq;
      int \fBrpma_conn_get_rcq\fP(const struct rpma_conn *conn, struct rpma_cq **rcq_ptr);

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBrpma_conn_get_rcq\fP() gets the receive CQ from the connection. The receive CQ allows handling all
\fBrpma_recv\fP(3) completions within the connection. It allows separating \fBrpma_recv\fP(3) completions
processing path from all other completions. The receive CQ is created only if the receive CQ
size in the provided connection configuration is greater than 0. When the receive CQ does not
exist for the given connection the *rcq_ptr == NULL.
.SH RETURN VALUE
The \fBrpma_conn_get_rcq\fP() function returns 0 on success or a negative error code on failure.
\fBrpma_conn_get_rcq\fP() does not set *rcq_ptr value on failure.
.SH ERRORS
\fBrpma_conn_get_rcq\fP() can fail with the following error:
.IP \(bu 3
RPMA_E_INVAL - conn or rcq_ptr is NULL
.SH SEE ALSO
\fBrpma_conn_cfg_set_rcq_size\fP(3), \fBrpma_conn_req_connect\fP(3), \fBrpma_conn_get_cq\fP(3), \fBrpma_cq_wait\fP(3),
\fBrpma_cq_get_wc\fP(3), \fBrpma_cq_get_fd\fP(3), \fBrpma_recv\fP(3), \fBlibrpma\fP(7) and https://pmem.io/rpma/