NAME    [Toc]    [Back]

       tis_cond_wait  - Causes a thread to wait for the specified
       condition variable to be signaled or broadcast

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_cond_wait(
               pthread_cond_t *cond,
               pthread_mutex_t *mutex );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Address of the condition variable (passed by reference) on
       which to wait.  Address of the mutex (passed by reference)
       that is associated with the condition  variable  specified
       in cond.

DESCRIPTION    [Toc]    [Back]

       When  threads are present, this routine causes a thread to
       wait for the specified condition variable cond to be  signaled
 or broadcast.

       Calling this routine in a single-threaded environment is a
       coding error.  Because no other thread exists to  issue  a
       call to tis_cond_signal(3) or tis_cond_broadcast(3), using
       this routine in a single-threaded environment  forces  the
       program to exit.

       For  more information about actions taken when threads are
       present, refer to the pthread_cond_wait(3) description.

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 is not a valid condition variable
       or the value specified by mutex is not a valid mutex,  or:
       Different    mutexes    are    supplied   for   concurrent
       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.

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)

       Manuals: Guide to DECthreads and Programmer's Guide



                                                 tis_cond_wait(3)