NAME    [Toc]    [Back]

       tis_cond_timedwait - Causes a thread to wait for the specified
 condition variable to be signaled or broadcast, such
       that it will awake after a specified period of time

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

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

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Condition  variable  that  the  calling  thread  waits on.
       Mutex associated with the condition variable specified  in
       cond.   Absolute  time  at  which the wait expires, if the
       condition has not been signaled  or  broadcast.   See  the
       tis_get_expiration(3)  routine,  which is used to obtain a
       value for this argument.

       The abstime argument is specified in Universal Coordinated
       Time (UTC). In the UTC-based model, time is represented as
       seconds since the Epoch. The Epoch is defined as the  time
       0 hours, 0 minutes, 0 seconds, January 1st, 1970 UTC. Seconds
 since the Epoch is a value interpreted as the  number
       of seconds between a specified time and the Epoch.

DESCRIPTION    [Toc]    [Back]

       If threads are not present, this function is equivalent to
       sleep(3).

       This 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 argument.

       This routine is identical to tis_cond_wait(3), except that
       this routine can return before  a  condition  variable  is
       signaled  or  broadcast;  specifically, when the specified
       time   expires.   For   more    information,    see    the
       tis_cond_wait(3) description.

       This  routine  automatically releases the mutex and causes
       the calling thread to wait  on  the  condition.  When  the
       thread   regains  control  after  calling  tis_cond_timedwait(3), the mutex is locked and the thread is the  owner.
       This  is true regardless of why the wait ended. If general
       cancelability is enabled, the thread  requires  the  mutex
       (blocking  if  necessary)  before the cleanup handlers are
       run (or before the exception is raised).

       If the current time equals or exceeds the expiration time,
       this  routine returns immediately, releasing and reacquiring
 the mutex. It might cause the calling thread to  yield
       (see  the  sched_yield(3)  description).  Your code should
       check the return status whenever this routine returns  and
       take  the  appropriate  action.  Otherwise, waiting on the
       condition variable can become a nonblocking loop.

       Call this routine after you have locked the  mutex  specified
  in  mutex.  The  results  of this routine are unpredictable
 if this routine is called without  first  locking
       the  mutex.  The only routines which are supported for use
       with asynchronous cancelability enabled  are  those  which
       disable asynchronous cancelability.

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values are as follows: Successful completion.  The
       value specified by cond, mutex, or abstime is invalid, or:
       Different    mutexes    are    supplied   for   concurrent
       tis_cond_timedwait(3) or  tis_cond_wait(3)  operations  on
       the  same  condition variable, or: The mutex was not owned
       by the calling thread at the time of the call.  DECthreads
       cannot  acquire  memory needed to block using a statically
       initialized condition variable.   The  time  specified  by
       abstime expired.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:   tis_cond_broadcast(3),   tis_cond_destroy(3),
       tis_cond_init(3),  tis_cond_signal(3),   tis_cond_wait(3),
       tis_get_expiration(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                            tis_cond_timedwait(3)