tis_cond_init - Initializes a condition variable
pthread_cond_t *cond );
Standard C Library (libc.so, libc.a)
Address of the condition variable (passed by reference) to
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
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 - automatic (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).
If an error condition occurs, the following occurs: The
routine returns an integer value indicating the type of
error. The condition variable 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 implementation
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.
Functions: tis_cond_broadcast(3), tis_cond_destroy(3),
Manuals: Guide to DECthreads and Programmer's Guide
[ Back ]