rpma_mr_get_descriptor(3)
rpma_mr_get_descriptor - get a descriptor of a memory region
Description
rpma_mr_get_descriptor
NAME
rpma_mr_get_descriptor - get a descriptor of a memory region
SYNOPSIS
#include <librpma.h>
struct
rpma_mr_local;
int rpma_mr_get_descriptor(const struct rpma_mr_local
*mr, void *desc);
DESCRIPTION
rpma_mr_get_descriptor() writes a network-transferable description of the provided local memory region (called ’descriptor’). Once the descriptor is transferred to the other side it should be decoded by rpma_mr_remote_from_descriptor() to create a remote memory region’s structure which allows for Remote Memory Access. Please see librpma(7) for details.
SECURITY WARNING
See rpma_mr_remote_from_descriptor(3).
RETURN VALUE
The rpma_mr_get_descriptor() function returns 0 on success or a negative error code on failure.
ERRORS
rpma_mr_get_descriptor() can fail with the following error:
|
• |
RPMA_E_INVAL - mr or desc is NULL |
SEE ALSO
rpma_mr_get_descriptor_size(3), rpma_mr_reg(3), librpma(7) and https://pmem.io/rpma/