_lwp_cond_broadcast(S)

_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(SYNCH).

References

_lwp_cond_signal(S), _lwp_cond_timedwait(S), _lwp_cond_wait(S), cond_broadcast(SYNCH), cond_destroy(SYNCH), cond_init(SYNCH), cond_signal(SYNCH), cond_timedwait(SYNCH), cond_wait(SYNCH)

Notices

Lightweight processes (LWPs) are internal interfaces and are subject to change. Their use should be avoided.