Scroll to navigation

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

NAME

rpma_mr_remote_from_descriptor - create a memory region from a descriptor

SYNOPSIS


#include <librpma.h>
struct rpma_mr_remote;
int rpma_mr_remote_from_descriptor(const void *desc, size_t desc_size,
struct rpma_mr_remote **mr_ptr);

DESCRIPTION

Create a remote memory region's structure based on the provided descriptor with a network-transferable description of the memory region local to the remote peer.

RETURN VALUE

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

ERRORS

rpma_mr_remote_from_descriptor() can fail with the following errors:

  • RPMA_E_INVAL - desc or mr_ptr is NULL
  • RPMA_E_INVAL - incompatible descriptor size
  • RPMA_E_NOSUPP - deserialized information does not represent a valid memory region
  • RPMA_E_NOMEM - out of memory

SEE ALSO

rpma_mr_remote_delete(3), rpma_mr_remote_get_flush_type(3), rpma_mr_remote_get_size(3), rpma_flush(3), rpma_read(3), rpma_write(3), rpma_atomic_write(3), librpma(7) and https://pmem.io/rpma/

25 August 2022 RPMA