_lwp_cond_broadcast(2)
_lwp_cond_broadcast --
broadcast a wake up to all LWPs waiting on a condition variable
Synopsis
#include <synch.h>
int _lwp_cond_broadcast(lwp_cond_t *cond);
Parameters
cond-
pointer to condition variable to be broadcast
Description
_lwp_cond_broadcast wakes up all the lightweight processes (LWPs)
waiting on the condition cond.
If more than one LWP is waiting, the order of release from the blocked group is
scheduling policy-dependent.
_lwp_cond_broadcast has no effect if there are no LWPs waiting on the
indicated condition.
cond parameter
The condition variable denoted by cond
must previously have been statically initialized (zero-filled).
Return values
_lwp_cond_broadcast returns zero for success
and an error number for failure, as described below.
Errors
If any of the following conditions is detected,
_lwp_cond_broadcast returns the corresponding value:
EINVAL-
The condition variable pointed to by cond is invalid.
EFAULT-
The cond parameter points to an illegal address.
(This error may not be detected; a SIGSEGV signal may be posted to the
faulting LWP if an illegal address is used.)
Usage
See the description of how to use condition variables
under USAGE on
cond_init(3synch).
References
_lwp_cond_signal(2),
_lwp_cond_timedwait(2),
_lwp_cond_wait(2),
cond_broadcast(3synch),
cond_destroy(3synch),
cond_init(3synch),
cond_signal(3synch),
cond_timedwait(3synch),
cond_wait(3synch)
Notices
Lightweight processes (LWPs) are internal interfaces and are subject
to change. Their use should be avoided.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004