tis_cond_wait(3) [osf1 man page]

tis_cond_wait(3)					     Library Functions Manual						  tis_cond_wait(3)

NAME

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

LIBRARY

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

SYNOPSIS

       #include <tis.h>

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

STANDARDS

       None

PARAMETERS

       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

       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_sig-
       nal(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

       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

       None

RELATED INFORMATION

       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

       delim off

																  tis_cond_wait(3)

tis_cond_init(3)					     Library Functions Manual						  tis_cond_init(3)

NAME

       tis_cond_init - Initializes a condition variable.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       int tis_cond_init(
			pthread_cond_t		  *cond);

STANDARDS

       None

PARAMETERS

       Address of the condition variable (passed by reference) to be initialized.

DESCRIPTION

       This routine initializes a condition variable (cond) with the DECthreads default condition variable attributes.

       A  condition  variable is a synchronization object used in conjunction with a mutex.  A mutex controls access to shared data.  When threads
       are present, a condition variable allows threads to wait for data to enter a defined state.

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

       Your program can use the macro PTHREAD_COND_INITIALIZER to initialize statically allocated condition variables to  the  DECthreads  default
       condition variable attributes.  Static initialization can be used only for a condition variable with storage class extern or static - auto-
       matic (stack local) objects must be initialized by calling tis_cond_destroy(3).	Use this macro as follows:

       pthread_cond_t condition = PTHREAD_COND_INITIALIZER

       When statically initialized, a condition variable should not also be initialized using tis_cond_init(3).

RETURN VALUES

       If an error condition occurs, the following occurs: The routine returns an integer value indicating the type of error.  The condition vari-
       able is not initialized.  The contents of condition variable cond are undefined.

       The possible return values are as follows: Successful completion.  The system lacks the necessary resources to initialize another condition
       variable, or The system-imposed limit on the total number of condition variables under execution by a single user is exceeded.  The  imple-
       mentation  has detected an attempt to reinitialize the object referenced by cond, a previously initialized, but not yet destroyed condition
       variable.  The value specified by attr is not a valid condition variable.  Insufficient memory exists to initialize the condition variable.

ERRORS

       None

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																  tis_cond_init(3)