1dat_srq_free(3DAT) Direct Access Transport Library Functionsdat_srq_free(3DAT)
2
3
4

NAME

6       dat_srq_free - destroy an instance of the shared receive queue
7

SYNOPSIS

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

PARAMETERS

19       srq_handle    A handle for an instance of SRQ to be destroyed.
20
21

DESCRIPTION

23       The  dat_srq_free()  function  destroys an instance of the SRQ. The SRQ
24       cannot be destroyed if it is in use by an EP.
25
26
27       It is illegal to use the destroyed handle in any consequent operation.
28

RETURN VALUES

30       DAT_SUCCESS           The operation was successful.
31
32
33       DAT_INVALID_HANDLE    The srq_handle argument is an invalid DAT handle.
34
35
36       DAT_SRQ_IN_USE        The Shared Receive Queue  can  not  be  destroyed
37                             because  it  is  in  still  associated with an EP
38                             instance.
39
40

USAGE

42       If the Provider detects the use of a deleted object handle,  it  should
43       return DAT_INVALID_HANDLE. The Provider should avoid assigning the used
44       handle as long as possible. Once reassigned the handle is no  longer  a
45       handle of a destroyed object.
46

ATTRIBUTES

48       See attributes(5) for descriptions of the following attributes:
49
50
51
52
53       ┌─────────────────────────────┬─────────────────────────────┐
54       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
55       ├─────────────────────────────┼─────────────────────────────┤
56       │Interface Stability          │Standard: uDAPL, 1.2         │
57       ├─────────────────────────────┼─────────────────────────────┤
58       │MT-Level                     │Unsafe                       │
59       └─────────────────────────────┴─────────────────────────────┘
60

SEE ALSO

62       dat_srq_create(3DAT),   dat_srq_post_recv(3DAT),   dat_srq_query(3DAT),
63       dat_srq_resize(3DAT), dat_srq_set_lw(3DAT), libdat(3LIB), attributes(5)
64
65
66
67SunOS 5.11                        16 Jul 2004               dat_srq_free(3DAT)
Impressum