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

名称

pthread_attr_setschedparam，pthread_attr_getschedparam-在线程属性对象中设置/获取调度参数属性

语法

#include <pthread.h>

int pthread_attr_setschedparam(pthread_attr_t *attr,
                               const struct sched_param *param);
int pthread_attr_getschedparam(const pthread_attr_t *attr,
                               struct sched_param *param);

Compile and link with -pthread.

说明

pthread_attr_setschedparam()函数将attr所引用的线程属性对象的调度参数属性设置为param所指向的缓冲区中指定的值。这些属性确定使用线程属性对象attr创建的线程的调度参数。

pthread_attr_getschedparam()返回由param指向的缓冲区中线程属性对象attr的调度参数属性。

调度参数以以下结构维护：

struct sched_param {
    int sched_priority;     /* Scheduling priority */
};

可以看出，仅支持一个调度参数。有关每个调度策略中调度优先级的允许范围的详细信息，请参见sched(7)。

为了使pthread_attr_setschedparam()进行的参数设置在调用pthread_create(3)时生效，调用者必须使用pthread_attr_setinheritsched(3)将属性对象attr的Inherited-Scheduler属性设置为PTHREAD_EXPLICIT_SCHED。

返回值

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

错误说明

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

EINVAL

在参数中指定的优先级对于attr的当前调度策略没有意义。

POSIX.1还记录了pthread_attr_setschedparam()的ENOTSUP错误。在Linux上永远不会返回此值(但是，可移植且面向未来的应用程序仍应处理此错误返回值)。

属性

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

遵循规范

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

备注

有关Linux支持的线程调度策略的列表，请参见pthread_attr_setschedpolicy(3)。

示例

请参见pthread_setschedparam(3)。

另外参见

sched_get_priority_min(2)，pthread_attr_init(3)，pthread_attr_setinheritsched(3)，pthread_attr_setschedpolicy(3)，pthread_create(3)，pthread_setschedparam(3)，pthread_setschedprio(3)，pthreads(7)，

出版信息

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