SCHED_SETAFFINITY

名前

書式

#define _GNU_SOURCE             /* feature_test_macros(7) 参照 */
#include <sched.h>

int sched_setaffinity(pid_t pid, size_t cpusetsize,
                      const cpu_set_t *mask);

int sched_getaffinity(pid_t pid, size_t cpusetsize,
                      cpu_set_t *mask);

説明

CPU affinity マスクは「CPU の集合」を表す cpu_set_t 構造体で表現され、 cpu_set_t へのポインター mask で指定される。 CPU 集合を操作するためのマクロ群については CPU_SET(3) で記載されている。

sched_setaffinity() は、スレッド ID が pid のスレッドの CPU affinity マスクを mask で指定された値に設定する。 pid が 0 の場合、呼び出し元スレッドが使われる。 cpusetsize 引き数には mask が指すデータの長さ (バイト単位) である。 通常は、この引き数には sizeof(cpu_set_t) を指定すればよい。

pid で指定されたスレッドが mask で指定された CPU のいずれかで現在実行されていない場合、 そのスレッドは mask で指定された CPU のいずれかに移動される。

sched_getaffinity() は、 スレッド ID が pid のスレッドの affinity マスクを mask が指す cpu_set_t 構造体に書き込む。 cpusetsize 引き数には mask の (バイト単位の) 大きさを指定する。  

返り値

エラー

EFAULT

指定されたメモリー番地が不正である。

EINVAL

システム上に現在実際に存在し、かつ "cpuset" 機構が課す制限においてそのスレッドに対して許可されている プロセッサが、 affinity ビットマスク mask に含まれていない。 "cpuset" 機構については cpuset(7) を参照。

EINVAL

(sched_getaffinity() と、カーネル 2.6.9 以前の sched_setaffinity()) cpusetsize がカーネルで使われている affinity マスクのサイズより小さい。

EPERM

(sched_setaffinity()) 呼び出し元のスレッドに適切な特権がなかった。 呼び出し元は、実効ユーザー ID が pid で識別されるスレッドの実ユーザー ID または実効ユーザー ID と同じであるか、 CAP_SYS_NICE ケーパビリティ (capability) を持たなければならない。

ESRCH

ID が pid のスレッドが見つからなかった。

バージョン

準拠

注意

システムで利用可能な CPU 数を判定する方法はいくつかある。 /proc/cpuinfo の内容を調べる、 sysconf(3) を使って _SC_NPROCESSORS_CONF と _SC_NPROCESSORS_ONLN の値を取得する、 /sys/devices/system/cpu/ の CPU ディレクトリの一覧を調べる、などがある。

sched(7) に Linux のスケジューリング方式についての説明がある。

affinity マスクはスレッド単位の属性で、スレッドグループの 各スレッド単位に独立して調整することができる。 gettid(2) コールからの返り値をこのコールの pid 引き数として渡すことができる。 pid に 0 を指定すると呼び出し元のスレッドの属性が設定され、 getpid(2) コールからの返り値を pid に指定するとスレッドグループのメインスレッドの属性が設定される (POSIX スレッド API を使用している場合、 sched_setaffinity() の代わりに pthread_setaffinity_np(3) を使用すること)。

fork(2) 経由で生成された子プロセスは親プロセスの CPU affinity マスクを継承する。 affinity マスクは execve(2) の前後で保存される。  

C ライブラリとカーネル ABI の違い

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

C ライブラリとカーネル ABI の違い

関連項目

この文書について