1dat_rmr_create(3DAT)Direct Access Transport Library Functiondsat_rmr_create(3DAT)
2
3
4
6 dat_rmr_create - create an RMR for the specified Protection Zone
7
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
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
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
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
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
66 dat_rmr_bind(3DAT) , libdat(3LIB), attributes(5)
67
68
69
70SunOS 5.11 16 Jul 2004 dat_rmr_create(3DAT)