tis_cond_broadcast(3) [osf1 man page]

tis_cond_broadcast(3)					     Library Functions Manual					     tis_cond_broadcast(3)

NAME

       tis_cond_broadcast - Wakes all threads that are waiting on the specified condition variable.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       int tis_cond_broadcast(
			pthread_cond_t	*cond);

STANDARDS

       None

PARAMETERS

       Address of the condition variable (passed by reference) on which to broadcast.

DESCRIPTION

       When threads are not present, this routine performs no actions.

       When threads are present, this routine unblocks all threads waiting on the specified condition variable cond.

       For more information about actions when threads are present, refer to the pthread_cond_broadcast(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 invalid.)

ERRORS

       None

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															     tis_cond_broadcast(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)