NAME

dat_rmr_create - create an RMR for the specified Protection Zone

SYNOPSIS

cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>
DAT_RETURN


    dat_rmr_create(


    IN    DAT_PZ_HANDLE     pz_handle,


    OUT   DAT_RMR_HANDLE    *rmr_handle


    )

PARAMETERS

pz_handle

Handle for an instance of the Protection Zone.

rmr_handle

Handle for the created instance of an RMR.

DESCRIPTION

The dat_rmr_create() function creates an RMR for the specified Protection Zone. This operation is relatively heavy. The created RMR can be bound to a memory region within the LMR through a lightweight dat_rmr_bind(3DAT) operation that generates rmr_context.

If the operation fails (does not return DAT_SUCCESS), the return values of rmr_handle are undefined and Consumers should not use them.

The pz_handle parameter provide Consumers a way to restrict access to an RMR by authorized connection only.

RETURN VALUES

DAT_SUCCESS

The operation was successful.

DAT_INSUFFICIENT_RESOURCES

The operation failed due to resource limitations.

DAT_INVALID_HANDLE

The pz_handle parameter is invalid.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Standard: uDAPL, 1.1, 1.2
MT-Level	Safe