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/