名前

ioprio_get, ioprio_set - I/O スケジューリングクラスと優先度の設定/取得

書式

int ioprio_get(int which, int who);
int ioprio_set(int which, int who, int ioprio);

注意: これらのシステムコールには glibc ラッパー関数は存在しない。 「注意」の節を参照。

説明

システムコール ioprio_get() / ioprio_set() は、(1つ以上の) スレッドの I/O スケジューリングクラスと 優先度の取得/設定を行う。

which と who 引き数でシステムコールの操作対象となるスレッドを指示する。 which 引き数は、 who をどのように解釈するかを決めるもので、以下のいずれか一つを指定する。

IOPRIO_WHO_PROCESS

who は特定のプロセスやスレッドを特定するためのプロセス ID かスレッド ID である。 who が 0 の場合、呼び出し元のスレッドに対して操作が行われる。

IOPRIO_WHO_PGRP

who はプロセスグループ ID であり、プロセスグループの全メンバが対象となる。 who が 0 の場合、 呼び出し元がメンバーとなっているプロセスグループに対して操作が行われる。

IOPRIO_WHO_USER

who はユーザーID であり、実 UID に一致する全プロセスが対象となる。

ioprio_get() の呼び出し時に which に IOPRIO_WHO_PGRP か IOPRIO_WHO_USER が指定され、 who に一致するプロセスが複数あった場合、 一致するプロセス全体の中で最も高い優先度が返される。 優先度が高いとは、より高い優先度クラスに属している (IOPRIO_CLASS_RT が最も高い優先度クラスで、 IOPRIO_CLASS_IDLE が最も低い)、もしくは 同じ優先度クラスに属しているが優先度レベルが高い (優先度番号が小さい方が優先度レベルが高いことを意味する)、 ということである。

ioprio_set() に渡す ioprio 引き数は、対象となるプロセスに割り当てるスケジューリングクラスと 優先度の両方を指定するビットマスクである。 ioprio の値を組み立てたり解釈するのに、以下のマクロが利用できる。

IOPRIO_PRIO_VALUE(class, data)

スケジューリングクラス class と優先度 (data) を与えると、このマクロは 2つの値を組み合わせて、 ioprio 値を生成し、マクロの結果として返す。

IOPRIO_PRIO_CLASS(mask)

mask (ioprio 値) を与えると、このマクロは I/O クラス要素、つまり IOPRIO_CLASS_RT, IOPRIO_CLASS_BE, IOPRIO_CLASS_IDLE のいずれか一つの値を返す。

IOPRIO_PRIO_DATA(mask)

mask (ioprio 値) を与えると、このマクロは優先度 (data) 要素を返す。

スケジューリングクラスと優先度に関する詳しい情報は、 「備考」の節を参照のこと。

I/O 優先度は読み出しと同期書き込み (O_DIRECT, O_SYNC) に対応している。 I/O 優先度は非同期書き込みには対応していない。なぜなら、 非同期書き込みはメモリー書き換えを行うプログラムの動作 (context) とは 関係なく発行され、そのためプログラム単位の優先度は適用されないから である。

返り値

成功すると、 ioprio_get() は、 which と who で指定された基準に合致した全プロセスで最も高い I/O 優先度を持つプロセスの ioprio 値を返す。 エラーの場合、-1 を返し、 errno にエラーを示す値を設定する。

成功すると、 ioprio_set() は 0 を返す。 エラーの場合、-1 を返し、 errno にエラーを示す値を設定する。

エラー

EINVAL

which か ioprio の値が不正である。 ioprio 用に指定可能なスケジューラクラスと優先度レベルについては 「備考」を参照のこと。

EPERM

呼び出し元プロセスが、指定されたプロセスに ioprio を割り当てるのに必要な権限を持っていない。 ioprio_set() に必要な権限についての詳しい情報は「備考」の節を参照のこと。

ESRCH

which と who で指定された基準に合致するプロセスが見つからなかった。

バージョン

これらのシステムコールはカーネル 2.6.13 以降の Linux で利用可能である。

準拠

これらのシステムコールは Linux 独自である。

注意

glibc はこれらのシステムコールに対するラッパー関数を提供していない。 syscall(2) を使って呼び出すこと。

複数のプロセスやスレッドが一つの I/O コンテキストを共有する場合がある。 clone(2) を CLONE_IO フラグ付きで呼び出した場合にはこの状況となる。 しかしながら、デフォルトでは、一つのプロセスの個々のスレッドは I/O コンテキストを共有「しない」。 したがって、 プロセス内のすべてのスレッドの I/O 優先度を変更したい場合には、 それぞれのスレッドに対して ioprio_set() を呼び出す必要がある。 この操作を行うのに必要となるスレッド ID には gettid(2) か clone(2) が返す値を指定する。

これらのシステムコールは、I/O 優先度に対応した I/O スケジューラと 組み合わせて使用された場合にのみ効果を持つ。 カーネル 2.6.17 では、この条件を満たすスケジューラは Completely Fair Queuing (CFQ) I/O スケジューラだけである。

$ cat /sys/block/hda/queue/scheduler
noop anticipatory deadline [cfq]

$ su
Password:
# echo cfq > /sys/block/hda/queue/scheduler

バグ

glibc は、このページに記載された関数プロトタイプやマクロを定義する 適切なヘッダーファイルをまだ提供していない。 必要な定義については linux/ioprio.h を見ればよい。

関連項目

ionice(1), getpriority(2), open(2), capabilities(7)

Linux カーネルソース内の Documentation/block/ioprio.txt

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。