pthread_attr_init(3T)pthread_attr_init(3T)NAMEpthread_attr_init(), pthread_attr_destroy() - initialize or destroy a
thread attributes object
SYNOPSISPARAMETERS
attr Pointer to the thread attributes object to be initial‐
ized or destroyed.
DESCRIPTION
initializes a thread attributes object attr with the default value for
all the thread attributes.
When a thread attributes object is used to create a thread, the values
of the individual attributes determine the characteristics of the new
thread. Attributes objects act like additional parameters to object
creation. A single attributes object can be used in multiple calls to
After a thread attributes object has been used to initialize one or
more threads, any function affecting the attributes object does not
affect the previously created threads.
The thread attributes and their default values are:
stacksize POSIX.1c does not define a default value. On
HP-UX released on PA-RISC platforms, the
default is 64K. On HP-UX released on Ita‐
nium(R)-based platforms, the default is 256K.
guardsize The default value is bytes.
stackaddr The default value is NULL.
detachstate The default value is
contentionscope POSIX.1c does not define a default value. The
default value is set to The scope can also be
specified externally by using the options
listed in the pthread_scope_options(5) man‐
page.
inheritsched POSIX.1c does not define a default value. On
HP-UX, the default value is
schedpolicy POSIX.1c does not define a default value. On
HP-UX, the default value is
schedparam POSIX.1c does not define a default value.
processor The default value is
binding_type The default value is
If an initialized thread attributes object is reinitialized, the ini‐
tialization results in undefined behavior.
destroys the thread attributes object attr. The destroyed thread
attributes object ceases to exist and its resources are reclaimed. Ref‐
erencing the object after it has been destroyed results in undefined
behavior. A destroyed thread attributes object can be reinitialized
using thread attribute initialization routine
Threads that have already been created using this attributes object are
not affected by the destruction of the thread 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 pthread attributes object.
[EINVAL] The value specified by attr is invalid.
If any of the following occur, the function returns the corresponding
error number:
[EINVAL] The value specified by attr is invalid.
AUTHOR
and were derived from the IEEE POSIX P1003.1c standard.
SEE ALSOpthread_create(3T).
STANDARDS CONFORMANCE
Pthread Library pthread_attr_init(3T)