Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

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);

Compile and link with -pthread.

说明

pthread_attr_setstacksize()函数将attr引用的线程属性对象的堆栈大小属性设置为stacksize中指定的值。

堆栈大小属性确定将为使用线程属性对象attr创建的线程分配的最小大小(以字节为单位)。

pthread_attr_getstacksize()函数在堆栈大小指向的缓冲区中返回attr所引用的线程属性对象的堆栈大小属性。

返回值

成功时，这些函数返回0；否则，返回0。错误时，它们返回非零错误号。

错误说明

pthread_attr_setstacksize()可能因以下错误而失败：

EINVAL

堆栈大小小于PTHREAD_STACK_MIN(16384)字节。

在某些系统上，如果stacksize不是系统页面大小的倍数，pthread_attr_setstacksize()可能会因错误EINVAL而失败。

版本

从2.1版开始，这些功能由glibc提供。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008。

备注

有关新线程的默认堆栈大小的详细信息，请参见pthread_create(3)。

创建线程时，线程的堆栈大小是固定的。只有主线程可以动态增长其堆栈。

pthread_attr_setstack(3)函数允许应用程序设置线程将使用的调用方分配堆栈的大小和位置。

BUGS

与glibc 2.8一样，如果指定的堆栈大小不是STACK_ALIGN的倍数(在大多数体系结构上为16个字节)，则可能会向下舍入，这违反了POSIX.1，后者表示分配的堆栈将至少为堆栈大小字节。

示例

请参见pthread_create(3)。

另外参见

getrlimit(2)，pthread_attr_init(3)，pthread_attr_setguardsize(3)，pthread_attr_setstack(3)，pthread_create(3)，pthreads(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。