PTHREAD_ATTR_SETSTACKSIZE(3)

ИМЯ
pthread_attr_setstacksize, pthread_attr_getstacksize - изменяет/возвращает атрибут размера стека у объекта атрибутов нити

ОБЗОР
#include <pthread.h>

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

Компилируется и компонуется вместе с -pthread.

ОПИСАНИЕ
Функция pthread_attr_setstacksize() изменяет атрибут размера стека у объекта атрибутов нити, на который указывает attr, в значение stacksize.

Атрибутом размера стека определяется минимальный размер (в байтах), который будет выделен для нитей, созданных с учётом объекта атрибутов нити attr.

Функция pthread_attr_getstacksize() возвращает атрибут размера стека у объекта атрибутов нити, на который указывает attr, в буфер на который указывает stacksize.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении эти функции возвращают 0; при ошибке возвращается ненулевой номер ошибки.

ОШИБКИ
Функция pthread_attr_setstacksize() может завершиться со следующей ошибкой:

EINVAL
    Размер стека меньше PTHREAD_STACK_MIN (16384) байт.

В некоторых системах pthread_attr_setstacksize() может завершиться ошибкой EINVAL, если значение stacksize не кратно размеру системной страницы.

ВЕРСИИ
Эти функции доступны в glibc начиная с версии 2.1.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
pthread_attr_setstacksize(), pthread_attr_getstacksize() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ
Подробную информацию о размере стека по умолчанию для новых нитей смотрите в pthread_create(3).

Размер стека нити не изменяется во время создания нити. Только главная нить может динамически увеличивать свой стек.

Функция pthread_attr_setstack(3) позволяет приложению изменять размер и положение стека вызывающего, который будет использован нитью.

ДЕФЕКТЫ
Как указано в glibc 2.8, если указанное значение stacksize не кратно STACK_ALIGN (для большинства архитектур 16 байт), то оно может быть округлено в меньшую сторону, нарушая при этом POSIX.1, где говорится, что выделенный стек должен быть не менее stacksize байт.

ПРИМЕР
Смотрите pthread_create(3).

СМОТРИТЕ ТАКЖЕ
getrlimit(2), pthread_attr_init(3), pthread_attr_setguardsize(3), pthread_attr_setstack(3), pthread_create(3), pthreads(7)