cond_signal(3synch)


cond_signal -- wake up a single thread waiting on a condition variable

Synopsis

   cc [options] -Kthread file
   

#include <synch.h>

int cond_signal(cond_t *cond);

Description

cond_signal wakes up a single thread, if one exists, waiting on the condition cond. If more than one thread is waiting, the choice of which to release from the blocked group is scheduling policy-specific: Bound threads have priority over multiplexed threads; then within each category the choice of thread is scheduling-policy-specific.

cond_signal has no effect if there are no threads waiting on cond.

A cond_signal will be more reliable if the associated mutex used by waiters is held across the call.

Parameters


cond
pointer to condition variable to be signaled

cond parameter

The condition variable denoted by cond must previously have been initialized (see cond_init(3synch)).

Usage

See the description of how to use condition variables under USAGE on condition(3synch).

Return values

cond_signal returns zero for success and an error number for failure.

Errors

If any of the following conditions is detected, cond_signal returns the corresponding value:

EINVAL
invalid argument specified

References

condition(3synch), cond_broadcast(3synch), cond_destroy(3synch), cond_init(3synch), cond_timedwait(3synch), cond_wait(3synch), Intro(3synch)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004