Content-type: text/html Man page of dat_rmr_create

dat_rmr_create

Section: Direct Access Transport Library Functions (3DAT)
Updated: 16 Jul 2004
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
Interface StabilityStandard: uDAPL, 1.1, 1.2
MT-LevelSafe

 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:40:02 GMT, October 02, 2010