NAME

    pthread_cond_timedwait - Causes a thread to wait for a condition
                             variable to be signaled or broadcast

 SYNOPSIS

     #include <pthread.h>

     int pthread_cond_timedwait( pthread_cond_t  *cond,
                                 pthread_mutex_t *mutex,
                                 struct timespec *abstime );

 PARAMETERS

     cond              Condition variable waited on.

     mutex             Mutex associated with the condition variable
                       specified in cond.

     abstime           Absolute time at which the wait expires, if the
                       condition has not been signaled or broadcast.
                       (See the pthread_get_expiration_np() routine,
                       which you can use to obtain a value for this
                       parameter.)

 DESCRIPTION

 The pthread_cond_timedwait() routine causes a thread to wait until one
 of the following occurs:

    o  The specified condition variable is signaled or broadcast.

    o  The current system clock time is greater than or equal to the time
       specified by the abstime parameter.

 This routine is identical to pthread_cond_wait() except that this rou-
 tine can return before a condition variable is signaled or broadcast-
 specifically, when a specified time expires.

 If the current time equals or exceeds the expiration time, this  routine
 returns immediately, without causing the current thread to wait.

 Call this routine after you lock the  mutex  specified  in  mutex.   The
 results  of  this  routine  are  unpredictable if this routine is called
 without first locking the mutex.

 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, mutex, or
                         abstime is invalid.

    -1      [EAGAIN]     The time specified by abstime expired.

    -1      [EDEADLK]    A deadlock condition is detected.

 RELATED INFORMATION

     FUNCTIONS:  pthread_cond_broadcast
                 pthread_cond_destroy
                 pthread_cond_init
                 pthread_cond_signal
                 pthread_cond_wait
                 pthread_get_expiration_np