PTHREAD_ATTR_SETSTACKADDR - Linux手册页

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

Linux程序员手册 第3部分
更新日期: 2017-09-15

名称

pthread_attr_setstackaddr,pthread_attr_getstackaddr-在线程属性对象中设置/获取堆栈地址属性

语法

#include <pthread.h>

int pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr);
int pthread_attr_getstackaddr(const pthread_attr_t *attr, void **stackaddr);

Compile and link with -pthread.

说明

这些功能已过时:请勿使用它们。请改用pthread_attr_setstack(3)和pthread_attr_getstack(3)。

pthread_attr_setstackaddr()函数将attr引用的线程属性对象的堆栈地址属性设置为stackaddr中指定的值。此属性指定使用线程属性对象attr创建的线程应使用的堆栈位置。

stackaddr应该指向由调用方分配的至少PTHREAD_STACK_MIN个字节的缓冲区。分配的缓冲区的页应该是可读写的。

pthread_attr_getstackaddr()函数在由stackaddr指向的缓冲区中返回attr所引用的线程属性对象的堆栈地址属性。

返回值

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

错误说明

没有定义错误(但是应用程序仍然应该处理可能的错误返回)。

版本

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

属性

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

InterfaceAttributeValue
pthread_attr_setstackaddr(),pthread_attr_getstackaddr()Thread safetyMT-Safe

遵循规范

POSIX.1-2001指定了这些功能,但将其标记为过时的。 POSIX.1-2008删除了这些功能的规范。

备注

不要使用这些功能!由于无法提供指定增长方向或堆栈范围的方法,因此无法便携使用。例如,在堆栈向下增长的体系结构上,stackaddr指定下一个地址,该地址超出分配的堆栈区域的最高地址。但是,在堆栈向上增长的体系结构中,stackaddr指定分配的堆栈区域中的最低地址。相比之下,pthread_attr_setstack(3)和pthread_attr_getstack(3)使用的stackaddr始终是指向分配的堆栈区域中最低地址的指针(而stacksize参数指定堆栈的范围)。

出版信息

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