pthread_attr_setscope

名前

pthread_attr_setscope, pthread_attr_getscope - スレッド属性オブジェクトの contention scope 属性の設定/取得を行う

書式

#include <pthread.h>

int pthread_attr_setscope(pthread_attr_t *attr, int scope);
int pthread_attr_getscope(const pthread_attr_t *attr, int *scope);

-pthread でコンパイルしてリンクする。

pthread_attr_setscope() 関数は、 attr が参照するスレッド属性オブジェクトの contention scope 属性を scope で指定された値に設定する。 contention scope 属性により、スレッドが CPU などのリソースを取り合うスレッド集合が規定される。 POSIX.1 では scope に指定する値として 2 つの値が規定されている。

PTHREAD_SCOPE_SYSTEM: スレッドは、同じスケジューリング割り当てドメイン (一つ以上のプロセッサのグループ) にある、システム上の全てのプロセスの自分以外の全てのスレッドとリソースを取り合う。 PTHREAD_SCOPE_SYSTEM のスレッドは、スケジューリングポリシーと優先度に基づき、互いに相対的にスケジューリングされる。

PTHREAD_SCOPE_PROCESS: スレッドは、contention scope が PTHREAD_SCOPE_PROCESS で作成された同じプロセスの自分以外の全てのスレッドとリソースを取り合う。 PTHREAD_SCOPE_PROCESS のスレッドは、スケジューリングポリシーと優先度に基づき、同じプロセスの他のスレッドと相対的にスケジューリングされる。 POSIX.1 では、これらのスレッドがシステム上の他のプロセスのスレッドや同じプロセス内の contention scope が PTHREAD_SCOPE_SYSTEM で作成された他のスレッドとどのようにリソースを取り合うかは、規定されないままになっている。

POSIX.1 で求められているのは、スレッド実装がこれらの contention scope のうち少なくとも 1 つをサポートすることだけである。 Linux は PTHREAD_SCOPE_SYSTEM をサポートしているが、 PTHREAD_SCOPE_PROCESS はサポートしていない。

複数の contention scope をサポートしているシステムで、 pthread_create(3) を呼び出した際に pthread_attr_setscope() で行ったパラメーター設定を有効にするには、呼び出し側で pthread_attr_setinheritsched(3) を使って属性オブジェクト attr の inherit-scheduler 属性を PTHREAD_EXPLICIT_SCHED に設定しておかなければならない。

pthread_attr_getscope() は、スレッド属性オブジェクト attr の contention scope 属性を scope が指すバッファーに入れて返す。

返り値

成功すると、これらの関数は 0 を返す。エラーの場合、0 以外のエラー番号を返す。

エラー

pthread_attr_setscope() は以下のエラーで失敗する場合がある。

EINVAL: scope に無効な値が指定された。

ENOTSUP: scope に値 PTHREAD_SCOPE_PROCESS が指定された。この値は Linux でサポートされていない。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。

インターフェース	属性	値
pthread_attr_setscope(), pthread_attr_getscope()	Thread safety	MT-Safe

Linux

pthread_attr_setscope

名前

書式

説明

返り値

エラー

属性

準拠

注意

関連項目

この文書について

Recommended readings

Questions & Answers