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(7) 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_setdetachstate(3C),
pthread_attr_setstackaddr(3C),
pthread_create(3C),
attributes(7),
standards(7) March 23, 2005 PTHREAD_ATTR_GETSTACKSIZE(3C)
