DAT_RMR_CREATE(3DAT)DAT_RMR_CREATE(3DAT)NAMEdat_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 Protec‐
tion 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 lim‐
itations.
DAT_INVALID_HANDLE
The pz_handle parameter is invalid.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬───────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼───────────────────────────┤
│Interface Stability │ Standard: uDAPL, 1.1, 1.2 │
├────────────────────┼───────────────────────────┤
│MT-Level │ Safe │
└────────────────────┴───────────────────────────┘
SEE ALSOdat_rmr_bind(3DAT) , libdat(3LIB), attributes(5)
Jul 16, 2004 DAT_RMR_CREATE(3DAT)