dat_cno_free(3dat)

1dat_cno_free(3DAT) Direct Access Transport Library Functionsdat_cno_free(3DAT)
2
3
4

NAME

6       dat_cno_free - destroy an instance of the CNO
7

SYNOPSIS

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

PARAMETERS

19       cno_handle    Handle for an instance of the CNO
20
21

DESCRIPTION

23       The dat_cno_free() function destroys a specified instance of the CNO.
24
25
26       A  CNO  cannot be deleted while it is referenced by an Event Dispatcher
27       or while a thread is blocked on it.
28

RETURN VALUES

30       DAT_SUCCESS           The operation was successful.
31
32
33       DAT_INVALID_HANDLE    The cno_handle() parameter is invalid.
34
35
36       DAT_INVALID_STATE     Parameter in an invalid state. CNO is in  use  by
37                             an  EVD  instance or there is a thread blocked on
38                             it.
39
40

USAGE

42       If there is a thread blocked in dat_cno_wait(3DAT), the Consumer can do
43       the following steps to unblock the waiter:
44
45           o      Create  a temporary EVD that accepts software events. It can
46                  be created in advance.
47
48           o      For a CNO with the waiter, attach that EVD to  the  CNO  and
49                  post the software event on the EVD.
50
51           o      This unblocks the CNO.
52
53           o      Repeat for other CNOs that have blocked waiters.
54
55           o      Destroy  the  temporary EVD after all CNOs are destroyed and
56                  the EVD is no longer needed.
57

ATTRIBUTES

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