1dat_lmr_free(3DAT) Direct Access Transport Library Functionsdat_lmr_free(3DAT)
2
3
4

NAME

6       dat_lmr_free - destroy an instance of the LMR
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_lmr_free (
14           IN    DAT_LMR_HANDLE    lmr_handle
15           )
16
17

PARAMETERS

19       lmr_handle:    Handle for an instance of LMR to be destroyed.
20
21

DESCRIPTION

23       The  dat_lmr_free()  function  destroys an instance of the LMR. The LMR
24       cannot be destroyed if it is in use by an RMR. The operation  does  not
25       deallocate the memory region or unpin memory on a host.
26
27
28       Use  of  the  handle  of  the destroyed LMR in any subsequent operation
29       except for dat_lmr_free()  fails.  Any  DTO  operation  that  uses  the
30       destroyed  LMR  after  the  dat_lmr_free()  is completed shall fail and
31       report a protection violation. The use of rmr_context of the  destroyed
32       LMR  by  a  remote  peer for an RDMA DTO results in an error and broken
33       connection on which it was used. Any remote RDMA  operation  that  uses
34       the destroyed LMR rmr_context, whose Transport-specific request arrived
35       to the local host after the dat_lmr_free()  has  completed,  fails  and
36       reports  a  protection  violation.  Remote RDMA operation that uses the
37       destroyed LMR rmr_context, whose Transport-specific request arrived  to
38       the  local host prior to the dat_lmr_free() returns, might or might not
39       complete  successfully.  If  it  fails,  DAT_DTO_ERR_REMOTE_ACCESS   is
40       reported  in  DAT_DTO_COMPLETION_STATUS for the remote RDMA DTO and the
41       connection is broken.
42

RETURN VALUES

44       DAT_SUCCESS           The operation was successful.
45
46
47       DAT_INVALID_HANDLE    The lmr_handle parameter is invalid.
48
49
50       DAT_INVALID_STATE     Parameter in an invalid state; LMR is in  use  by
51                             an RMR instance.
52
53

ATTRIBUTES

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

SEE ALSO

69       libdat(3LIB), attributes(5)
70
71
72
73SunOS 5.11                        16 Jul 2004               dat_lmr_free(3DAT)
Impressum