NAME

     pthread_cond_broadcast - Wakes all threads that are waiting on
                              a condition variable

 SYNOPSIS

     #include <pthread.h>

     int pthread_cond_broadcast(pthread_cond_t *cond);

 PARAMETERS

     cond                Condition variable broadcast.

 DESCRIPTION

 The pthread_cond_broadcast() routine wakes all threads waiting on a con-
 dition variable. Calling this routine implies that data guarded by the
 associated mutex has changed so that it might be possible for one or
 more waiting threads to proceed. If any one waiting thread might be able
 to proceed, call pthread_cond_signal().

 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:

    Return   Error      Description
    ___________________________________________________________
    0                   Successful completion.

    -1      [EINVAL]    The value specified by cond is invalid.

 RELATED INFORMATION

     FUNCTIONS:  pthread_cond_destroy
                  pthread_cond_init
                  pthread_cond_signal
                  pthread_cond_timedwait
                  pthread_cond_wait