DAT_RMR_CREATE(3DAT) Direct Access Transport Library Functions

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 |
+--------------------+---------------------------+

SEE ALSO

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

July 16, 2004 DAT_RMR_CREATE(3DAT)