VMS Help DCE_THREADS, Application Routines, pthread_cond_timedwait  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  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