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

      struct rpma_conn;
      struct rpma_conn_private_data;
      int \fBrpma_conn_get_private_data\fP(const struct rpma_conn *conn,
                      struct rpma_conn_private_data *pdata);

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBrpma_conn_get_private_data\fP() obtains the pointer to the private data given by the other side of
the connection.
.SH SECURITY WARNING
The connection's private data is insecure. An attacker might modify all data transferred
via the rdma_cm private data. Users should avoid using \fBrpma_conn_get_private_data\fP(3)
and \fBrpma_conn_req_get_private_data\fP(3) API calls and they should utilize TLS/SSL connections
to transfer all configuration data between peers instead.
.SH RETURN VALUE
The \fBrpma_conn_get_private_data\fP() function returns 0 on success or a negative error code on
failure. \fBrpma_conn_get_private_data\fP() does not set *pdata value on failure.
.SH ERRORS
\fBrpma_conn_get_private_data\fP() can fail with the following error:
.IP \(bu 3
RPMA_E_INVAL - conn or pdata is NULL
.SH SEE ALSO
\fBrpma_conn_req_connect\fP(3), \fBlibrpma\fP(7) and https://pmem.io/rpma/