NAME

       rpma_conn_req_new - create a new outgoing connection request object

SYNOPSIS

             #include <librpma.h>

             struct rpma_peer;
             struct rpma_conn_cfg;
             struct rpma_conn_req;
             int rpma_conn_req_new(struct rpma_peer *peer, const char *addr, const char *port,
                             const struct rpma_conn_cfg *cfg, struct rpma_conn_req **req_ptr);

DESCRIPTION

       rpma_conn_req_new()  creates a new outgoing connection request object using reliable, connection-oriented
       and message-based (RDMA_PS_TCP) QP communication.

RETURN VALUE

       The  rpma_conn_req_new()  function  returns  0  on  success  or  a  negative  error  code   on   failure.
       rpma_conn_req_new()  does  not set *req_ptr value on failure. If cfg is NULL, then the default values are
       used

       •  see rpma_conn_cfg_new(3) for more details.

ERRORS

       rpma_conn_req_new() can fail with the following errors:

       •  RPMA_E_INVAL - peer, addr, port or req_ptr is NULL

       •  RPMA_E_NOMEM - out of memory

       •  RPMA_E_PROVIDER - rdma_create_id(3), rdma_resolve_addr(3), rdma_resolve_route(3)  or  ibv_create_cq(3)
          failed

SEE ALSO

       rpma_conn_cfg_new(3),     rpma_conn_req_connect(3),    rpma_conn_req_delete(3),    rpma_conn_req_recv(3),
       rpma_ep_next_conn_req(3), rpma_peer_new(3), librpma(7) and https://pmem.io/rpma/

RPMA                                              01 April 2024                             rpma_conn_req_new(3)