pthread_mutexattr_init(3T)pthread_mutexattr_init(3T)NAMEpthread_mutexattr_init(), pthread_mutexattr_destroy() - initialize or
destroy a mutex attributes object
SYNOPSISPARAMETERS
attr Pointer to the mutex attributes object to be initial‐
ized or destroyed.
DESCRIPTION
initializes the mutex attributes object attr with the default values
for all attributes. The attributes object describes a mutex in detail
and is passed to the mutex initialization function.
When a mutex attributes object is used to initialize a mutex, the val‐
ues of the individual attributes determine the characteristics of the
new mutex. Attributes objects act like additional parameters to object
initialization. A single attributes object can be used in multiple
calls to the function
When a mutex is initialized with an attributes object, the attributes
are, in effect, copied into the mutex. Consequently, any change to the
attributes object will not affect any previously initialized mutexes.
Once all mutexes needing a specific attributes object have been ini‐
tialized, the attributes object is no longer needed.
The mutex attributes and their default values are:
The default value is
The default value is
If an initialized mutex attributes object is reinitialized, undefined
behavior results.
destroys the mutex attributes object attr. The destroyed mutex
attributes object ceases to exist and its resources are reclaimed.
Using attr after it has been destroyed results in undefined behavior.
A destroyed mutex attributes object can be reinitialized using the
function.
Mutexes that have been already initialized using this attributes object
are not affected by the destruction of the mutex 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
For each of the following conditions, if the condition is detected, the
and functions return the corresponding error number:
[ENOMEM] There is insufficient memory available in which
to initialize attr.
[EINVAL] The value specified by attr is invalid.
AUTHOR
and were derived from the IEEE POSIX P1003.1c standard.
SEE ALSOpthread_create(3T), pthread_mutexattr_getpshared(3T), pthread_mutex‐
attr_setpshared(3T), pthread_mutexattr_gettype(3T), pthread_mutex‐
attr_settype(3T), pthread_mutex_init(3T).
STANDARDS CONFORMANCE
Pthread Library pthread_mutexattr_init(3T)