名称

pthread_setschedparam, pthread_getschedparam — スレッドスケジュールパラメータ操作

ライブラリ

POSIX Threads Library (libpthread, -lpthread)

書式

#include < pthread.h>

int
pthread_setschedparam( pthread_t thread, int policy, const struct sched_param *param);

int
pthread_getschedparam( pthread_t thread, int *policy, struct sched_param *param);

解説

pthread_setschedparam() と pthread_getschedparam() 関数は、個別のスレッドのスケジュールパラメータを設定し取得します。スレッドのためのスケジューリングポリシは、 SCHED_FIFO (ファーストイン、ファーストアウト)、 SCHED_RR (ラウンドロビン)、または SCHED_OTHER (タイムシェアリング) のいずれかを指定できます。 ( param->sched_priority によってアクセスされる) 有効なスレッドのプライオリティは、 sched_get_priority_min(2) と sched_get_priority_max(2) システムコールで返される範囲でなければなりません。

戻り値

成功すれば、これらの関数は、0 を返します。そうでなければ、エラーを示すためにエラー番号を返します。

エラー

pthread_setschedparam() 関数は、次の場合に失敗します:

[ EINVAL]

policy が、無効の値です。

[ ENOTSUP]

スケジュールパラメータが、無効の値です。

[ ESRCH]

thread が、存在しないスレッドです。

pthread_getschedparam() 関数は、次の場合に失敗します:

[ ESRCH]

thread が、存在しないスレッドです。

関連項目

sched_get_priority_max(2), sched_get_priority_min(2)

規格

pthread_setschedparam() と pthread_getschedparam() 関数は、 Version 2 of the Single UNIX Specification (“SUSv2”) に適合しています。