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)