pthread_attr_create(3) — Subroutines
Digital
NAME
pthread_attr_create − Creates a thread attributes object that is used to specify the attributes of threads when they are created.
SYNOPSIS
#include <pthread.h>
int pthread_attr_create(
pthread_attr_t ∗attr );
PARAMETERS
attrThread attributes object created.
DESCRIPTION
This routine creates a thread attributes object that is used to specify the attributes of threads when they are created. The attributes object created by this routine is only used in calls to pthread_create.
The individual attributes (internal fields) of the attributes object are set to default values. (The default values of each attribute are discussed in the descriptions of the following services.) Use the following routines to change the individual attributes:
•pthread_attr_setinheritsched
•pthread_attr_setprio
•pthread_attr_setsched
•pthread_attr_setstacksize
When an attributes object is used to create a thread, the values of the individual attributes determine the characteristics of the new object. Attributes objects perform in a manner similar to additional parameters. Changing individual attributes does not affect any objects that were previously created using the attributes object.
RETURN VALUES
If an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:
| Return | Error | Description |
| 0 | Successful completion. | |
| −1 | [ENOMEM] | Insufficient memory exists to create the thread attributes object. |
| −1 | [EINVAL] | The value specified by attr is invalid. |
RELATED INFORMATION
pthread_attr_delete(3), pthread_attr_setinheritsched(3), pthread_attr_setprio(3), pthread_attr_setsched(3), pthread_attr_setstacksize(3), pthread_create(3)