pthread_cond_signal(3-thr) pthread_cond_signal(3-thr)
NAME
pthreadcondsignal - wakes one thread that is waiting on a condition
variable
SYNOPSIS
#include <pthread.h>
int pthreadcondsignal(pthreadcondt *cond);
PARAMETERS
cond Condition variable signaled.
DESCRIPTION
The pthreadcondsignal() routine wakes one thread waiting on a condi-
tion variable. Calling this routine implies that data guarded by the
associated mutex has changed so that it is possible for a single wait-
ing thread to proceed. Call this routine when any thread waiting on
the specified condition variable might find its predicate true, but
only one thread needs to proceed.
The scheduling policy determines which thread is awakened. For poli-
cies SCHEDFIFO and SCHEDRR a blocked thread is chosen in priority
order.
Call this routine when the associated mutex is either locked or
unlocked.
RETURN VALUES
If the function fails, errno may be set to one of the following
values:
EINVAL The value specified by cond is invalid.
SEE ALSO
pthreadcondbroadcast(3-thr), pthreadconddestroy(3-thr),
pthreadcondinit(3-thr), pthreadcondtimedwait(3-thr),
pthreadcondwait(3-thr).
Page 1 Reliant UNIX 5.44 Printed 11/98