1dat_rmr_create(3DAT)Direct Access Transport Library Functiondsat_rmr_create(3DAT)
2
3
4

NAME

6       dat_rmr_create - create an RMR for the specified Protection Zone
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_rmr_create(
14           IN    DAT_PZ_HANDLE     pz_handle,
15           OUT   DAT_RMR_HANDLE    *rmr_handle
16           )
17
18

PARAMETERS

20       pz_handle     Handle for an instance of the Protection Zone.
21
22
23       rmr_handle    Handle for the created instance of an RMR.
24
25

DESCRIPTION

27       The  dat_rmr_create() function creates an RMR for the specified Protec‐
28       tion Zone. This operation is relatively heavy. The created RMR  can  be
29       bound  to  a  memory  region  within  the  LMR  through  a  lightweight
30       dat_rmr_bind(3DAT) operation that generates rmr_context.
31
32
33       If the operation fails (does not return DAT_SUCCESS), the return values
34       of rmr_handle are undefined and Consumers should not use them.
35
36
37       The  pz_handle  parameter provide Consumers a way to restrict access to
38       an RMR by authorized connection only.
39

RETURN VALUES

41       DAT_SUCCESS                   The operation was successful.
42
43
44       DAT_INSUFFICIENT_RESOURCES    The operation failed due to resource lim‐
45                                     itations.
46
47
48       DAT_INVALID_HANDLE            The pz_handle parameter is invalid.
49
50

ATTRIBUTES

52       See attributes(5) for descriptions of the following attributes:
53
54
55
56
57       ┌─────────────────────────────┬─────────────────────────────┐
58       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
59       ├─────────────────────────────┼─────────────────────────────┤
60       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │MT-Level                     │Safe                         │
63       └─────────────────────────────┴─────────────────────────────┘
64

SEE ALSO

66       dat_rmr_bind(3DAT) , libdat(3LIB), attributes(5)
67
68
69
70SunOS 5.11                        16 Jul 2004             dat_rmr_create(3DAT)
Impressum