rpma_peer_cfg_from_descriptor(3)

rpma_peer_cfg_from_descriptor3

Create a peer cfg from the descriptor

Usage

      #include <librpma.h>
      struct rpma_peer_cfg;
      int rpma_peer_cfg_from_descriptor(const void *desc, size_t desc_size,
                      struct rpma_peer_cfg **pcfg_ptr);

Overview

rpma_peer_cfg_from_descriptor() creates a peer configuration object from the descriptor.

Security warning

An attacker might modify the serialized remote node configuration while it is transferred via an unsecured connection (e.g. rdma_cm private data), which might cause different remote persistency method selections. The most dangerous situation is switching from the GPSPM mode to the APM one. Users should avoid using rpma_conn_get_private_data(3) and rpma_conn_req_get_private_data(3) API calls and they should utilize TLS/SSL connections to transfer all configuration data between peers instead.

Return value

The rpma_peer_cfg_from_descriptor() function returns 0 on success or a negative error code on failure. rpma_peer_cfg_from_descriptor() does not set *pcfg_ptr value on failure.

Errors

rpma_peer_cfg_from_descriptor() can fail with the following errors:

•

RPMA_E_INVAL - desc or pcfg_ptr are NULL

•

RPMA_E_NOMEM - out of memory

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

From librpma-dev 1.3.0-2+b3 in Debian 13 (Trixie). Parsed by carta from the page's man source.