PTHREAD_ATTR_GETSTACKSIZE(3C) Standard C Library Functions


NAME


pthread_attr_getstacksize, pthread_attr_setstacksize - get or set
stacksize attribute

SYNOPSIS


cc -mt [ flag... ] file... -lpthread [ library... ]
#include <pthread.h>

int pthread_attr_getstacksize(const pthread_attr_t *restrict attr,
size_t *restrict stacksize);


int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);


DESCRIPTION


The functions pthread_attr_setstacksize() and
pthread_attr_getstacksize(), respectively, set and get the thread
creation stacksize attribute in the attr object.


The stacksize attribute defines the minimum stack size (in bytes)
allocated for the created threads stack. When the stacksize argument is
NULL, the default stack size becomes 1 megabyte for 32-bit processes and
2 megabytes for 64-bit processes.

RETURN VALUES


Upon successful completion, pthread_attr_setstacksize() and
pthread_attr_getstacksize() return a value of 0. Otherwise, an error
number is returned to indicate the error. The pthread_attr_getstacksize()
function stores the stacksize attribute value in stacksize if successful.

ERRORS


The pthread_attr_setstacksize() or pthread_attr_getstacksize() function
may fail if:

EINVAL
attr or stacksize is invalid.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


pthread_attr_init(3C), pthread_attr_setstackaddr(3C),
pthread_attr_setdetachstate(3C), pthread_create(3C), attributes(5),
standards(5)


March 23, 2005 PTHREAD_ATTR_GETSTACKSIZE(3C)