NAME
pthread_attr_getstacksize, pthread_attr_setstacksize – thread attribute operations
SYNOPSIS
#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
Thread attributes are used to specify parameters to pthread_create(). One attribute object can be used in multiple calls to pthread_create(), with or without modifications between calls.
The functions pthread_attr_setstacksize() and pthread_attr_getstacksize(), respectively, set and get the size of the stack that is to be created for the new thread. The stack size attribute is set within the attr argument, which can subsequently be used as an argument to pthread_create().
RETURN VALUES
If successful, these functions return 0. Otherwise, an error number is returned to indicate the error. pthread_attr_getstacksize() returns the stacksize attribute value in stacksize if successful.
ERRORS
pthread_attr_getstacksize() will fail if:
- [EINVAL]
-
Invalid value for attr.
pthread_attr_setstacksize() will fail if:
- [EINVAL]
-
Invalid value for attr.
- [EINVAL]
-
stacksize is less than PTHREAD_STACK_MIN.
- [EINVAL]
-
stacksize is not a multiple of the system page size.
SEE ALSO
pthread_create(3), pthread_attr_init(3), pthread_attr_setstackaddr(3)
STANDARDS
pthread_attr_setstacksize(), pthread_attr_getstacksize() conform to ISO/IEC 9945-1:1996 (“POSIX.1”)