This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_attr_setstacksize()

Set the thread stack-size attribute

Synopsis:

#include <pthread.h>

int pthread_attr_setstacksize( pthread_attr_t * attr,
                               size_t stacksize );

Arguments:

attr

A pointer to the pthread_attr_t structure that defines the attributes to use when creating new threads. For more information, see pthread_attr_init().

stacksize

The size of the stack you want to use in new threads. The minimum value of the thread stack-size attribute is PTHREAD_STACK_MIN.

Library:

libc

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

Description:

The pthread_attr_setstacksize() function sets the thread stack size attribute in the thread attribute object attr to stacksize.

Returns:

EOK

Success.

EINVAL

The value of stacksize is less than PTHREAD_STACK_MIN or greater than the system limit.

Classification:

POSIX 1003.1 THR TSS

Caveats:

The QNX interpretation of PTHREAD_STACK_MIN is enough memory to run a thread that does nothing:

void nothingthread( void )
{
    return;
}

See also:

pthread_attr_getstacksize(), pthread_attr_init(), pthread_create().