pthread_attr_setstacksize(3)
NAME
pthread_attr_setstacksize - Changes the stacksize attribute of thread creation
SYNOPSIS
#include <pthread.h>
int pthread_attr_setstacksize( pthread_attr_t *attr, long stacksize);
PARAMETERS
attrThread attributes object modified.
stacksizeNew value for the stacksize attribute. The stacksize parameter specifies the minimum size (in bytes) of the stack needed for a thread.
DESCRIPTION
The pthread_attr_setstacksize() routine sets the minimum size (in bytes) of the stack needed for a thread created using the attributes object specified by the attr parameter. Use this routine to adjust the size of the writable area of the stack. The default value of the stacksize attribute is machine specific. A thread’s stack is fixed at the time of thread creation. Only the main or initial thread can dynamically extend its stack. Most compilers do not check for stack overflow. Ensure that your thread stack is large enough for anything that you call from the thread.
RETURN VALUES
If the function fails, errno may be set to one of the following values:
| Return | Error | Description |
| 0 | Successful completion. | |
| \-1 | [EINVAL] | The value specified by attr is invalid. |
| \-1 | [EINVAL] | The value specified by stacksize is invalid. |
RELATED INFORMATION
Functions: pthread_attr_create(3), pthread_attr_getstacksize(3), pthread_create(3).
Hewlett-Packard Company — OSF DCE 1.1/HP DCE 1.5