|HP-UX Reference > P
HP-UX 11i Version 3: February 2007
pthread_attr_init(), pthread_attr_destroy() — initialize or destroy a thread attributes object
#include <pthread.h> int pthread_attr_init( pthread_attr_t *attr ); int pthread_attr_destroy( pthread_attr_t *attr );
pthread_attr_init() 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 pthread_create().
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:
If an initialized thread attributes object is reinitialized, the initialization results in undefined behavior.
pthread_attr_destroy() destroys the thread attributes object attr. The destroyed thread attributes object ceases to exist and its resources are reclaimed. Referencing the object after it has been destroyed results in undefined behavior. A destroyed thread attributes object can be reinitialized using thread attribute initialization routine pthread_attr_init().
Threads that have already been created using this attributes object are not affected by the destruction of the thread attributes object.
Upon successful completion, pthread_attr_init() and pthread_attr_destroy() return zero. Otherwise, an error number is returned to indicate the error (the errno variable is not set).
If any of the following occur, the pthread_attr_init() function returns the corresponding error number:
If any of the following occur, the pthread_attr_destroy() function returns the corresponding error number:
pthread_attr_init() and pthread_attr_destroy() were derived from the IEEE POSIX P1003.1c standard.