dat_rmr_create(3DATDirect Access Transport Library Functiodat_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
limitations.
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)SunOS 5.10 16 Jul 2004 dat_rmr_create(3DAT)