rpma_conn_req_connect(3)

rpma_conn_req_connect3

Initiate processing the connection request

Usage

      #include <librpma.h>
      struct rpma_conn_req;
      struct rpma_conn_private_data;
      struct rpma_conn;
      int rpma_conn_req_connect(struct rpma_conn_req **req_ptr,
                      const struct rpma_conn_private_data *pdata, struct rpma_conn **conn_ptr);

Overview

rpma_conn_req_connect() initiates processing the connection requests both incoming and outgoing. The end of processing is signalled by the RPMA_CONN_ESTABLISHED event via rpma_conn_next_event().

Return value

The rpma_conn_req_connect() function returns 0 on success or a negative error code on failure. On success, the newly created connection object is stored in *conn_ptr whereas *req_ptr is consumed and set to NULL. On failure, rpma_conn_req_connect() does not set *conn_ptr whereas *req_ptr is consumed and set to NULL.

Errors

rpma_conn_req_connect() can fail with the following errors:

•

RPMA_E_INVAL - req_ptr, *req_ptr or conn_ptr is NULL

•

RPMA_E_INVAL - pdata is not NULL whereas pdata->len == 0

•

RPMA_E_NOMEM - out of memory

•

RPMA_E_PROVIDER - initiating a connection request failed (active side only)

•

RPMA_E_PROVIDER - accepting the connection request failed (passive side only)

•

RPMA_E_PROVIDER - freeing a communication event failed (passive side only)

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.