1dat_evd_set_unwaitabDlier(e3cDtATA)ccess Transport LibrarydFautn_cetvido_nsset_unwaitable(3DAT)
2
3
4

NAME

6       dat_evd_set_unwaitable  -  transition  the  Event  Dispatcher  into  an
7       unwaitable state
8

SYNOPSIS

10       cc [ flag... ] file... -ldat [ library... ]
11       #include <dat/udat.h>
12
13       DAT_RETURN
14           dat_evd_set_unwaitable(
15           IN    DAT_EVD_HANDLE    evd_handle
16           )
17
18

PARAMETERS

20       evd_handle    Handle for an instance of Event Dispatcher.
21
22

DESCRIPTION

24       The dat_evd_set_unwaitable() transitions the Event Dispatcher  into  an
25       unwaitable  state.  In  this  state, calls to dat_evd_wait(3DAT) return
26       synchronously with  a  DAT_INVALID_STATE  error,  and  threads  already
27       blocked   in   dat_evd_wait()   are   awakened   and   return   with  a
28       DAT_INVALID_STATE error without any further action by the Consumer. The
29       actual   state   of   the   Event   Dispatcher  is  accessible  through
30       dat_evd_query(3DAT) and is DAT_EVD_UNWAITABLE after the return of  this
31       operation.
32
33
34       This call does not affect a CNO associated with this EVD at all. Events
35       arriving on the EVD after it is set unwaitable still  trigger  the  CNO
36       (if  appropriate),  and  can  be  retrieved with dat_evd_dequeue(3DAT).
37       Because events can arrive normally on the EVD, the EVD might  overflow;
38       the Consumer is expected to protect against this possibility.
39

RETURN VALUES

41       DAT_SUCCESS           The operation was successful.
42
43
44       DAT_INVALID_HANDLE    The evd_handle parameter is invalid.
45
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.1, 1.2    │
57       ├─────────────────────────────┼─────────────────────────────┤
58       │MT-Level                     │Safe                         │
59       └─────────────────────────────┴─────────────────────────────┘
60

SEE ALSO

62       dat_evd_clear_unwaitable(3DAT),                  dat_evd_dequeue(3DAT),
63       dat_evd_query(3DAT), dat_evd_wait(3DAT), libdat(3LIB), attributes(5)
64
65
66
67SunOS 5.11                        16 Jul 2004     dat_evd_set_unwaitable(3DAT)
Impressum