Scroll to navigation

rpma_conn_req_new(3) RPMA Programmer's Manual rpma_conn_req_new(3)

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.

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/
21 October 2020 RPMA