Wakes at least one thread that is waiting on the specified
    condition variable.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_cond_signal (
             pthread_cond_t   *cond);

2  –  Arguments

 cond

    Condition variable to be signaled.

3  –  Description

    This routine unblocks at least one thread waiting on the
    specified condition variable cond. Calling this routine implies
    that data guarded by the associated mutex has changed, thus it
    might be possible for one of the waiting threads to proceed. In
    general, only one thread will be released.

    If no threads are waiting on the specified condition variable,
    this routine takes no action. The signal does not propagate to
    the next condition variable wait.

    This routine should be called when any thread waiting on the
    specified condition variable might find its predicate true,
    but only one thread should proceed. If more than one thread can
    proceed, or if any of the threads would not be able to proceed,
    then you must use pthread_cond_broadcast().

    The scheduling policy determines which thread is awakened. For
    policies SCHED_FIFO and SCHED_RR, a blocked thread is chosen
    in priority order, using first-in/first-out (FIFO) within
    priorities.

    If the calling thread holds the lock to the target condition
    variable's associated mutex while setting the variable's wait
    predicate, that thread can call pthread_cond_signal() to signal
    the variable even after releasing the lock on that mutex.
    However, for more predictable scheduling behavior, call pthread_
    cond_signal() before releasing the target condition variable's
    associated mutex.

4  –  Return Values

    If an error condition occurs, this routine returns an integer
    value indicating the type of error. Possible return values are as
    follows:

    Return      Description

    0           Successful completion.
    [EINVAL]    The value specified by cond is not a valid condition
                variable.

5  –  Associated Routines

       pthread_cond_broadcast()
       pthread_cond_destroy()
       pthread_cond_init()
       pthread_cond_timedwait()
       pthread_cond_wait()