pthread_attr_setstacksize(3)pthread_attr_setstacksize(3)NAMEpthread_attr_setstacksize - Changes the stacksize attribute in the
specified thread attributes object
SYNOPSIS
#include <pthread.h>
int pthread_attr_setstacksize(
pthread_attr_t *attr,
size_t stacksize );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
Thread attributes object to be modified. New value for the stacksize
attribute of the thread attributes object specified by the attr argu‐
ment. The stacksize argument must be greater than or equal to
PTHREAD_STACK_MIN. PTHREAD_STACK_MIN specifies the minimum size (in
bytes) of stack needed for a thread.
DESCRIPTION
This routine sets the stacksize attribute in the thread attributes
object specified by the attr argument. Use this routine to adjust the
size of the writable area of the stack for a new thread.
The size of a thread's stack is fixed at the time of thread creation.
Only the initial thread can dynamically extend its stack.
Many compilers do not check for stack overflow. Ensure that the new
thread's stack is sufficient for the resources required by routines
that are called from the thread.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
Successful completion. The value specified by attr is invalid, or the
value specified by stacksize is less than PTHREAD_STACK_MIN or exceeds
a DECthreads-imposed limit.
ERRORS
None
SEE ALSO
Functions: pthread_attr_init(3), pthread_attr_getstacksize(3),
pthread_create(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_attr_setstacksize(3)