pthread_attr_setstacksize(3) Library Functions Manual pthread_attr_setstacksize(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 standards 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
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_attr_setstacksize(3)
Check Out this Related Man Page
PTHREAD_ATTR_SETSTACKSIZE(3) Linux Programmer's Manual PTHREAD_ATTR_SETSTACKSIZE(3)NAME
pthread_attr_setstacksize, pthread_attr_getstacksize - set/get stack size attribute in thread attributes object
SYNOPSIS
#include <pthread.h>
int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);
int pthread_attr_getstacksize(pthread_attr_t *attr, size_t *stacksize);
Compile and link with -pthread.
DESCRIPTION
The pthread_attr_setstacksize() function sets the stack size attribute of the thread attributes object referred to by attr to the value
specified in stacksize.
The stack size attribute determines the minimum size (in bytes) that will be allocated for threads created using the thread attributes
object attr.
The pthread_attr_getstacksize() function returns the stack size attribute of the thread attributes object referred to by attr in the buffer
pointed to by stacksize.
RETURN VALUE
On success, these functions return 0; on error, they return a nonzero error number.
ERRORS
pthread_attr_setstacksize() can fail with the following error:
EINVAL The stack size is less than PTHREAD_STACK_MIN (16384) bytes.
On some systems, pthread_attr_setstacksize() can fail with the error EINVAL if stacksize is not a multiple of the system page size.
VERSIONS
These functions are provided by glibc since version 2.1.
CONFORMING TO
POSIX.1-2001.
EXAMPLE
See pthread_create(3).
NOTES
For details on the default stack size of new threads, see pthread_create(3).
A thread's stack size is fixed at the time of thread creation. Only the main thread can dynamically grow its stack.
The pthread_attr_setstack(3) function allows an application to set both the size and location of a caller-allocated stack that is to be
used by a thread.
BUGS
As at glibc 2.8, if the specified stacksize is not a multiple of STACK_ALIGN (16 bytes on most architectures), it may be rounded downwards,
in violation of POSIX.1-2001, which says that the allocated stack will be at least stacksize bytes.
SEE ALSO getrlimit(2), pthread_attr_init(3), pthread_attr_setguardsize(3), pthread_attr_setstack(3), pthread_create(3), pthreads(7)COLOPHON
This page is part of release 3.25 of the Linux man-pages project. A description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2008-11-05 PTHREAD_ATTR_SETSTACKSIZE(3)