pthread_attr_init()

Initialize a thread-attribute object

Synopsis:

#include <pthread.h>

int pthread_attr_init( pthread_attr_t *attr );

Arguments:

attr

A pointer to the pthread_attr_t structure that you want to initialize. For more information, see below.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_attr_init() function initializes the thread attributes in the thread attribute object attr to their default values:

• Cancellation requests may be acted on according to the cancellation type (PTHREAD_CANCEL_DEFERRED).
• Cancellation requests are held pending until a cancellation point (PTHREAD_CANCEL_ENABLE).
• Threads are put into a zombie state when they terminate, and they stay in this state until you retrieve their exit status or detach them (PTHREAD_CREATE_JOINABLE).
• Threads inherit the scheduling policy of their parent thread (PTHREAD_INHERIT_SCHED).
• Threads are scheduled against all threads in the system (PTHREAD_SCOPE_SYSTEM).
• The stack attributes are set so that the kernel will allocate a 4 KB stack for new threads and free the stacks when the threads terminate.

After initialization, you can use the pthread_attr_* family of functions to get and set the attributes:

You can also set some non-POSIX attributes; for more information, see “QNX extensions,” in the documentation for pthread_create().

You can then pass the attribute object to pthread_create() to create a thread with the required attributes. You can use the same attribute object in multiple calls to pthread_create().

The effect of initializing an already-initialized thread-attribute object is undefined.

Returns:

EOK

Success.

Classification:

POSIX 1003.1 THR

See also:

pthread_attr_destroy(), pthread_create()

Processes and Threads chapter of Getting Started with QNX Neutrino