PTHREAD_ATTR_SETINHERITSCHED - Linux手册页

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

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

InterfaceAttributeValue
pthread_attr_setinheritsched(),pthread_attr_getinheritsched()Thread safetyMT-Safe

遵循规范

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

出版信息

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