Manual Pages for UNIX Operating System command usage for man dat_rmr_create

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_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  speci-
     fied  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




SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    dat_rmr_create(3DAT)



     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


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





































SunOS 5.11          Last change: 16 Jul 2004                    2