pthread_attr_init Subroutine

Purpose

Creates a thread attributes object and initializes it with default values.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_attr_init (attr)
pthread_attr_t *attr;

Description

The pthread_attr_init subroutine creates a new thread attributes object attr. The new thread attributes object is initialized with the following default values:

Always Initialized
Attribute	Default value
Contention-scope	PTHREAD_SCOPE_PROCESS the default ensures compatibility with implementations that do not support this POSIX option.
Inheritsched	PTHREAD_INHERITSCHED
Schedparam	A sched_param structure which sched_prio field is set to 1, the least favored priority.
Schedpolicy	SCHED_OTHER

Always Initialized
Attribute	Default value
Stacksize	PTHREAD_STACK_MIN
Guardsize	PAGESIZE

The resulting attribute object (possibly modified by setting individual attribute values), when used by pthread_create, defines the attributes of the thread created. A single attributes object can be used in multiple simultaneous calls to pthread_create.

Parameters

Return Values

Upon successful completion, the new thread attributes object is filled with default values and returned via the attr parameter, and 0 is returned. Otherwise, an error code is returned.

Error Codes

The pthread_attr_init subroutine is unsuccessful if the following is true:

This function will not return an error code of [EINTR].

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pthread_attr_setdetachstate subroutine, pthread_attr_setstackaddr subroutine, pthread_attr_setstacksize subroutine, pthread_create subroutine, pthread_attr_destroy and pthread_attr_setguardsize subroutine.

The pthread.h file.

Creating Threads in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Threads Library Options and Threads Library Quick Reference in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.