1dat_rmr_free(3DAT) Direct Access Transport Library Functionsdat_rmr_free(3DAT)
2
3
4

NAME

6       dat_rmr_free - destroy an instance of the RMR
7

SYNOPSIS

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

PARAMETERS

19       rmr_handle    Handle for an instance of the RMR to be destroyed.
20
21

DESCRIPTION

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

RETURN VALUES

44       DAT_SUCCESS           The operation was successful.
45
46
47       DAT_INVALID_HANDLE    The rmr_handle handle is invalid.
48
49

ATTRIBUTES

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

SEE ALSO

65       libdat(3LIB), attributes(5)
66
67
68
69SunOS 5.11                        16 Jul 2004               dat_rmr_free(3DAT)
Impressum