NAME

       rpma_peer_new - create a peer object

SYNOPSIS

             #include <librpma.h>

             struct ibv_context;
             struct rpma_peer;
             int rpma_peer_new(struct ibv_context *ibv_ctx, struct rpma_peer **peer_ptr);

DESCRIPTION

       rpma_peer_new() creates a new peer object.

RETURN VALUE

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

ERRORS

       rpma_peer_new() can fail with the following errors:

       •  RPMA_E_INVAL - ibv_ctx or peer_ptr is NULL

       •  RPMA_E_NOMEM - creating a verbs protection domain failed with ENOMEM.

       •  RPMA_E_PROVIDER - creating a verbs protection  domain  failed  with  error  other  than
          ENOMEM.

       •  RPMA_E_UNKNOWN - creating a verbs protection domain failed without error value.

       •  RPMA_E_NOMEM - out of memory

SEE ALSO

       rpma_conn_req_new(3),      rpma_ep_listen(3),     rpma_mr_reg(3),     rpma_peer_delete(3),
       rpma_utils_get_ibv_context(3), librpma(7) and https://pmem.io/rpma/