carta
pthread_attr_set_getstacksize(3)

pthread_attr_set_getstacksize3

Thread attribute operations

Usage

int

int

Overview

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.

Standards

pthread_attr_setstacksize(), pthread_attr_getstacksize() conform to ISO/IEC 9945-1:1996 (“POSIX.1”)

From libpthread 539.100.4 in macOS 26.5. Parsed by carta from the page's mdoc source.