 |
Index for Section 3 |
|
 |
Alphabetical listing for P |
|
pthread_condattr_init(3)
NAME
pthread_condattr_init - Initializes a condition variable attributes object.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
int pthread_condattr_init(
pthread_condattr_t *attr);
STANDARDS
Interfaces documented on this reference page conform to industry standards
as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
attr Address of the condition variable attributes object to be
initialized.
DESCRIPTION
This routine initializes the condition variable attributes object specified
by the (attr) argument with a set of default attribute values.
When an attributes object is used to create a condition variable, the
values of the individual attributes determine the characteristics of the
new condition variable. Attributes objects act as additional arguments to
condition variable creation. Changing individual attributes in an
attributes object does not affect any condition variables that were
previously created using that attributes object.
You can use the same condition variable attributes object in successive
calls to pthread_condattr_init(3), from any thread. If multiple threads
can change attributes in a shared attributes object, your program must use
a mutex to protect the integrity of that attributes object.
Results are undefined if this routine is called and the attr argument
specifies a condition variable attributes object that is already
initialized.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
0 Successful completion.
[ENOMEM] Insufficient memory exists to initialize the condition variable
attributes object.
ERRORS
None
RELATED INFORMATION
Functions: pthread_condattr_destroy(3), pthread_cond_init(3)
Manuals: Guide to DECthreads and Programmer's Guide