pthread_condattr_init(3T)pthread_condattr_init(3T)NAMEpthread_condattr_init(), pthread_condattr_destroy() - initialize or
destroy a condition variable attributes object.
SYNOPSISPARAMETERS
attr Pointer to the condition variable attributes object to
be initialized or destroyed.
DESCRIPTION
initializes the condition variable attributes object attr with the
default values for all attributes. The attributes object describes a
condition variable in detail and is passed to the condition variable
initialization function.
When a condition variable attributes object is used to initialize a
condition variable, the values of the individual attributes determine
the characteristics of the new condition variable. Attributes objects
act like additional parameters to object initialization. A single
attributes object can be used in multiple calls to the function
When a condition variable is initialized with an attributes object, the
attributes are, in effect, copied into the condition variable. Conse‐
quently, any change to the attributes object will not affect any previ‐
ously initialized condition variables. Once all condition variables
needing a specific attributes object have been initialized, the
attributes object is no longer needed.
The condition variable attributes and their default values are:
The default value is
If an initialized condition variable attributes object is reinitial‐
ized, undefined behavior results.
destroys the condition variable attributes object attr. The destroyed
condition variable attributes object ceases to exist and its resources
are reclaimed. Using attr after it has been destroyed results in unde‐
fined behavior. A destroyed condition variable attributes object can
be reinitialized using the function
Condition variables that have been already initialized using this
attributes object are not affected by the destruction of the condition
variable attributes object.
RETURN VALUE
Upon successful completion, and return zero. Otherwise, an error num‐
ber is returned to indicate the error (the variable is not set).
ERRORS
If any of the following occur, the function returns the corresponding
error number:
[ENOMEM] There is insufficient memory available in which
to initialize the condition variable attributes
object.
[EINVAL] attr is not a valid condition variable attributes
object.
For each of the following conditions, if the condition is detected, the
function returns the corresponding error number:
[EINVAL] attr is not a valid condition variable attributes
object.
AUTHOR
and were derived from the IEEE POSIX P1003.1c standard.
SEE ALSOpthread_create(3T), pthread_condattr_getpshared(3T),
pthread_cond_init(3T).
STANDARDS CONFORMANCE
Pthread Library pthread_condattr_init(3T)