Direct Access Transport Library Functions
datevdsetunwaitable(3DAT)
NAME
datevdsetunwaitable - transition the Event Dispatcher
into an unwaitable state
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include
DATRETURN
datevdsetunwaitable(
IN DATEVDHANDLE evdhandle
)
PARAMETERS
evdhandle Handle for an instance of Event Dispatcher.
DESCRIPTION
The datevdsetunwaitable() transitions the Event
Dispatcher into an unwaitable state. In this state, calls to
datevdwait(3DAT) return synchronously with a
DATINVALIDSTATE error, and threads already blocked in
datevdwait() are awakened and return with a
DATINVALIDSTATE error without any further action by the
Consumer. The actual state of the Event Dispatcher is acces-
sible through datevdquery(3DAT) and is DATEVDUNWAITABLE
after the return of this operation.
This call does not affect a CNO associated with this EVD at
all. Events arriving on the EVD after it is set unwaitable
still trigger the CNO (if appropriate), and can be retrieved
with datevddequeue(3DAT). Because events can arrive nor-
mally on the EVD, the EVD might overflow; the Consumer is
expected to protect against this possibility.
RETURN VALUES
DATSUCES The operation was successful.
DATINVALIDHANDLE The evdhandle parameter is invalid.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 16 Jul 2004 1
Direct Access Transport Library Functions
datevdsetunwaitable(3DAT)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Standard: uDAPL, 1.1, 1.2
MT-Level Safe
SEE ALSO
datevdclearunwaitable(3DAT), datevddequeue(3DAT),
datevdquery(3DAT), datevdwait(3DAT), libdat(3LIB),
attributes(5)
SunOS 5.11 Last change: 16 Jul 2004 2
Direct Access Transport Library Functions
datevdsetunwaitable(3DAT)
SunOS 5.11 Last change: 16 Jul 2004 3
|