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

      struct rpma_conn;
      struct rpma_cq;
      int \fBrpma_conn_get_cq\fP(const struct rpma_conn *conn, struct rpma_cq **cq_ptr);

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBrpma_conn_get_cq\fP() gets the main CQ from the connection. When the receive CQ is not present
the main CQ allows handling all completions within the connection. When the receive CQ
is present the main CQ allows handling all completions except \fBrpma_recv\fP(3) completions within
the connection. Please see \fBrpma_conn_get_rcq\fP(3) for details about the receive CQ.
.SH RETURN VALUE
The \fBrpma_conn_get_cq\fP() function returns 0 on success or a negative error code on failure.
\fBrpma_conn_get_cq\fP() does not set *cq_ptr value on failure.
.SH ERRORS
\fBrpma_conn_get_cq\fP() can fail with the following error:
.IP \(bu 3
RPMA_E_INVAL - conn or cq_ptr is NULL
.SH SEE ALSO
\fBrpma_conn_req_connect\fP(3), \fBrpma_conn_get_rcq\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/