dat_rmr_create(3DAT) Direct Access Transport Library Functions dat_rmr_create(3DAT)
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(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard: uDAPL, 1.1, 1.2 |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO
dat_rmr_bind(3DAT) , libdat(3LIB), attributes(5)
SunOS 5.10 16 Jul 2004 dat_rmr_create(3DAT)
