PTHREAD_COND_SIGNAL(3P)              BSD               PTHREAD_COND_SIGNAL(3P)



NAME
     pthread_cond_signal - Wakes up a thread that is waiting on a condition
     variable

SYNOPSIS
     #include <pthread.h>

     int pthread_cond_signal (cond)
     pthread_cond_t *cond;

DESCRIPTION
     The pthread_cond_signal function wakes up a thread, if one exists, that
     is waiting for the specified condition to be satisfied.

     The cond argument specifies the condition variable being waited on.

     If more than one thread is waiting on the condition, the thread to be
     awakened will be determined by the scheduler.

     This call has no effect if no threads are waiting on the condition.

NOTES
     This interface is based on draft 4 of the IEEE P1003.4a standard, and
     will be changed to conform to the final version.

DIAGNOSTICS
     Upon successful completion, a value of 0 (zero) is returned.  Otherwise,
     -1 is returned and errno is set to indicate the error.

ERRORS
     If the pthread_cond_signal function fails, errno may be set to the
     following value:

     [EINVAL]  The value specified by the cond argument is invalid.

SEE ALSO
     pthread_cond_wait(3P), pthread_cond_timedwait(3P)