1dat_cno_wait(3DAT) Direct Access Transport Library Functionsdat_cno_wait(3DAT)
2
3
4

NAME

6       dat_cno_wait - wait for notification events
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_cno_wait (
14           IN    DAT_CNO_HANDLE    cno_handle,
15           IN    DAT_TIMEOUT       timeout,
16           OUT   DAT_EVD_HANDLE    *evd_handle
17           )
18
19

PARAMETERS

21       cno_handle    Handle for an instance of CNO
22
23
24       timeout       The  duration  to  wait  for  a  notification.  The value
25                     DAT_TIMEOUT_INFINITE can be used to wait indefinitely.
26
27
28       evd_handle    Handle for an instance of EVD
29
30

DESCRIPTION

32       The dat_cno_wait() function allows the Consumer to wait  for  notifica‐
33       tion events from a set of Event Dispatchers all from the same Interface
34       Adapter. The Consumer blocks  until  notified  or  the  timeout  period
35       expires.
36
37
38       An  Event Dispatcher that is disabled or in the "Waited" state does not
39       deliver notifications. A uDAPL Consumer waiting directly upon an  Event
40       Dispatcher preempts the CNO.
41
42
43       The  consumer  can  optionally  specify  a  timeout,  after which it is
44       unblocked even if there are  no  notification  events.  On  a  timeout,
45       evd_handle is explicitly set to a null handle.
46
47
48       The  returned  evd_handle is only a hint. Another Consumer can reap the
49       Event before this Consumer can get around to checking  the  Event  Dis‐
50       patcher.  Additionally,  other Event Dispatchers feeding this CNO might
51       have been notified. The Consumer is responsible for ensuring  that  all
52       EVDs feeding this CNO are polled regardless of whether they are identi‐
53       fied as the immediate cause of the CNO unblocking.
54
55
56       All the waiters on the CNO, including the OS Wait Proxy Agent if it  is
57       associated with the CNO, are unblocked with the NULL handle returns for
58       an unblocking EVD evd_handle when the IA instance is destroyed or  when
59       all EVDs the CNO is associated with are freed.
60

RETURN VALUES

62       DAT_SUCCESS              The operation was successful.
63
64
65       DAT_INVALID_HANDLE       The cno_handle parameter is invalid.
66
67
68       DAT_QUEUE_EMPTY          The  operation  timed  out without a notifica‐
69                                tion.
70
71
72       DAT_INVALID_PARAMETER    One of the parameters was invalid  or  out  of
73                                range,   a   combination   of  parameters  was
74                                invalid, or the timeout parameter is invalid.
75
76
77       DAT_INTERRUPTED_CALL     The operation was  interrupted by a signal.
78
79

ATTRIBUTES

81       See attributes(5) for descriptions of the following attributes:
82
83
84
85
86       ┌─────────────────────────────┬─────────────────────────────┐
87       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
88       ├─────────────────────────────┼─────────────────────────────┤
89       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
90       ├─────────────────────────────┼─────────────────────────────┤
91       │MT-Level                     │Safe                         │
92       └─────────────────────────────┴─────────────────────────────┘
93

SEE ALSO

95       libdat(3LIB), attributes(5)
96
97
98
99SunOS 5.11                        16 Jul 2004               dat_cno_wait(3DAT)
Impressum