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)