PTHREAD_ATTR_SETSTACKSIZE - Linux手册页

时间:2019-08-20 18:01:02  来源:igfitidea点击:

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

InterfaceAttributeValue
pthread_attr_setstacksize(),pthread_attr_getstacksize()Thread safetyMT-Safe

遵循规范

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

出版信息

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