SCHED_SETAFFINITY

名前

書式

#define _GNU_SOURCE
#include <sched.h>

int sched_setaffinity(pid_t pid, size_t cpusetsize,
                      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 の (バイト単位の) 大きさを指定する。

関数 sched_getaffinity() は長さ len のポインタ mask にプロセス pid の affinity マスクを書き込む。 pid が 0 の場合、呼び出し元のプロセスのマスクが返される。  

返り値

エラー

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 のプロセスが見つからなかった。

バージョン

準拠

注意

sched_setscheduler(2) には 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) の前後で保存される。

このマニュアルページでは CPU affinity コールの glibc インタフェースを 説明している。実際のシステムコール・インタフェースは少し違っており、 実際の実装では CPU 集合は簡単なビットマスクであるという実状を反映し、 mask の型が unsigned long * となっている。 成功時には、生の sched_getaffinity() システムコール自身は cpumask_t データ型の (バイト単位の) 大きさを返す。 cpumask_t はカーネル内部で CPU 集合のビットマスクを表現するのに 使われているデータ型である。  

関連項目

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

関連項目