pthread_attr_init()

Initialize a thread-attribute object

Synopsis:

#include <pthread.h>

int pthread_attr_init( pthread_attr_t *attr );

Since:

BlackBerry 10.0.0

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 " 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

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Last modified: 2014-11-17



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus