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

名称

pthread_attr_setinheritsched，pthread_attr_getinheritsched-在线程属性对象中设置/获取Inherited-Scheduler属性

语法

#include <pthread.h>

int pthread_attr_setinheritsched(pthread_attr_t *attr,
                                 int inheritsched);
int pthread_attr_getinheritsched(const pthread_attr_t *attr,
                                 int *inheritsched);

Compile and link with -pthread.

说明

pthread_attr_setinheritsched()函数将attr所引用的线程属性对象的Inherited-Scheduler属性设置为Inheritsched中指定的值。 Inherited-Scheduler属性确定使用线程属性对象attr创建的线程是从调用线程继承其调度属性，还是从attr继承它们。

下列调度属性受Inherited-Scheduler属性影响：调度策略(pthread_attr_setschedpolicy(3))，调度优先级(pthread_attr_setschedparam(3))和争用范围(pthread_attr_setscope(3))。

可以在Inheritedched中指定以下值：

PTHREAD_INHERIT_SCHED

使用attr创建的线程从创建线程继承调度属性。 attr中的调度属性将被忽略。

PTHREAD_EXPLICIT_SCHED

使用attr创建的线程将从属性对象指定的值中获取其调度属性。

在新初始化的线程属性对象中，Inherited-Scheduler属性的默认设置为PTHREAD_INHERIT_SCHED。

pthread_attr_getinheritsched()返回Inheritsched指向的缓冲区中线程属性对象attr的Inherited-Scheduler属性。

返回值

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

错误说明

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

EINVAL

inheritsched中的值无效。

POSIX.1还记录了pthread_attr_setinheritsched()的可选ENOTSUP错误("尝试将属性设置为不受支持的值")。

属性

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

遵循规范

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

BUGS

与glibc 2.8一样，如果使用pthread_attr_init(3)初始化线程属性对象，则该属性对象的调度策略将设置为SCHED_OTHER，并且调度优先级将设置为0。但是，如果然后设置了Inherited-Scheduler属性到PTHREAD_EXPLICIT_SCHED，则使用属性对象创建的线程错误地从创建线程继承其调度属性。如果在调用pthread_create(3)之前在线程属性对象中显式设置了调度策略或调度优先级属性，则不会发生此错误。

示例

请参见pthread_setschedparam(3)。

另外参见

pthread_attr_init(3)，pthread_attr_setschedparam(3)，pthread_attr_setschedpolicy(3)，pthread_attr_setscope(3)，pthread_create(3)，pthread_setschedparam(3)，pthread_setschedprio(3)，pthreads(7)，sched(7)

出版信息

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