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(5) for descriptions of the following attributes:

See Also

dat_rmr_bind(3DAT) , libdat(3LIB), attributes(5)