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)