1dat_rmr_free(3DAT) Direct Access Transport Library Functionsdat_rmr_free(3DAT)
2
3
4
6 dat_rmr_free - destroy an instance of the RMR
7
9 cc [ flag... ] file... -ldat [ library... ]
10 #include <dat/udat.h>
11
12 DAT_RETURN
13 dat_rmr_free (
14 IN DAT_RMR_HANDLE rmr_handle
15 )
16
17
19 rmr_handle Handle for an instance of the RMR to be destroyed.
20
21
23 The dat_rmr_free() function destroys an instance of the RMR.
24
25
26 Use of the handle of the destroyed RMR in any subsequent operation
27 except for the dat_rmr_free() fails. Any remote RDMA operation that
28 uses the destroyed RMR rmr_context, whose Transport-specific request
29 arrived to the local host after the dat_rmr_free() has completed, fails
30 and reports a protection violation. Remote RDMA operation that uses the
31 destroyed RMR rmr_context, whose Transport-specific request arrived to
32 the local host prior to the dat_rmr_free() return, might or might not
33 complete successfully. If it fails, DAT_DTO_ERR_REMOTE_ACCESS is
34 reported in DAT_DTO_COMPLETION_STATUS for the remote RDMA DTO and the
35 connection is broken.
36
37
38 The dat_rmr_free() function is allowed on either bound or unbound RMR.
39 If RMR is bound, dat_rmr_free() unbinds (free HCA TPT and other
40 resources and whatever else binds with length of 0 should do), and then
41 free RMR.
42
44 DAT_SUCCESS The operation was successful.
45
46
47 DAT_INVALID_HANDLE The rmr_handle handle is invalid.
48
49
51 See attributes(5) for descriptions of the following attributes:
52
53
54
55
56 ┌─────────────────────────────┬─────────────────────────────┐
57 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
58 ├─────────────────────────────┼─────────────────────────────┤
59 │Interface Stability │Standard: uDAPL, 1.1, 1.2 │
60 ├─────────────────────────────┼─────────────────────────────┤
61 │MT-Level │Unsafe │
62 └─────────────────────────────┴─────────────────────────────┘
63
65 libdat(3LIB), attributes(5)
66
67
68
69SunOS 5.11 16 Jul 2004 dat_rmr_free(3DAT)