cond_broadcast(SYNCH)
cond_broadcast --
broadcast a wake-up call to all threads waiting on a condition variable
Synopsis
cc [options] -Kthread file
#include <synch.h>
int cond_broadcast(cond_t *cond);
Parameters
cond-
pointer to condition variable to be broadcast
Description
cond_broadcast wakes up all threads waiting on the condition cond.
If more than one thread is waiting, the order of release from the blocked group
is scheduling policy-specific for bound threads:
Bound threads have priority over multiplexed threads; then
within each category the choice of thread is scheduling-policy-specific.
cond_broadcast has no effect if there are no threads waiting on cond.
A cond_broadcast will be more reliable if the associated mutex
used by waiters is held across the call.
cond parameter
The condition variable denoted by cond must previously have been
initialized (see cond_init(SYNCH)).
Usage
See the description of how to use condition variables
under USAGE on
condition(SYNCH).
Return values
cond_broadcast returns zero for success
and an error number for failure.
Errors
If the following condition is detected,
cond_broadcast returns the corresponding value:
EINVAL-
invalid argument specified
References
Intro(SYNCH),
condition(SYNCH),
cond_destroy(SYNCH),
cond_init(SYNCH),
cond_signal(SYNCH),
cond_timedwait(SYNCH),
cond_wait(SYNCH)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 01 June 2005