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/