*** UNIX MANUAL PAGE BROWSER ***

pthread_a...tstacksize(3) Library Functions Manual pthread_a...tstacksize(3) NAME pthread_attr_setstacksize - Changes the stacksize attribute in the specified thread attributes object. LIBRARY DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS #include <pthread.h> int pthread_attr_setstacksize( pthread_attr_t *attr, size_t stacksize); 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 ob- ject 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 in- dicating 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 RELATED INFORMATION Functions: pthread_attr_init(3), pthread_attr_getstacksize(3), pthread_create(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_a...tstacksize(3)