pthread_cond_timedwait(3-thr) — Reliant UNIX 5.44c4

pthread_cond_timedwait(3-thr)                 pthread_cond_timedwait(3-thr)

NAME
     pthreadcondtimedwait - causes a thread to wait for a condition vari-
     able to be signaled or broadcast

SYNOPSIS
     #include <pthread.h>

     int pthreadcondtimedwait(
          pthreadcondt *cond,
          pthreadmutext *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
               pthreadgetexpirationnp() routine, which you can use to
               obtain a value for this parameter.)

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

     -  The specified condition variable is signaled or broadcast.

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

     This routine is identical to pthreadcondwait() 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 rou-
     tine 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:

     EINVAL    The value specified by cond, mutex, or abstime is invalid.

     EAGAIN    The time specified by abstime expired.

     EDEADLK   A deadlock condition is detected.



Page 1                       Reliant UNIX 5.44                Printed 11/98

pthread_cond_timedwait(3-thr)                 pthread_cond_timedwait(3-thr)

SEE ALSO
     pthreadcondbroadcast(3-thr), pthreadconddestroy(3-thr),
     pthreadcondinit(3-thr), pthreadcondsignal(3-thr),
     pthreadcondwait(3-thr), pthreadgetexpirationnp(3-thr).


















































Page 2                       Reliant UNIX 5.44                Printed 11/98

Museum