draft/man2/sched_setscheduler.2

   1 .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\"
  26 .\"*******************************************************************
  27 .\"
  28 .\" This file was generated with po4a. Translate the source file.
  29 .\"
  30 .\"*******************************************************************
  31 .\"
  32 .\" Japanese Version Copyright (c) 1996 Akira Yoshiyama
  33 .\"         all rights reserved.
  34 .\" Translated Thu Jul 11 01:42:52 JST 1996
  35 .\"         by Akira Yoshiyama <yosshy@jedi.seg.kobe-u.ac.jp>
  36 .\" Modified Sun Nov 21 19:36:18 JST 1999
  37 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  38 .\" Updated Wed Jan  1 JST 2003 by Kentaro Shirakata <argrath@ub32.org>
  39 .\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  40 .\" Updated & Modified 2005-10-10, Akihiro MOTOKI
  41 .\" Updated 2006-04-16, Akihiro MOTOKI, Catch up to LDP v2.28
  42 .\" Updated 2007-10-13, Akihiro MOTOKI, LDP v2.65
  43 .\" Updated 2008-08-13, Akihiro MOTOKI, LDP v3.05
  44 .\" Updated 2012-06-04, Akihiro MOTOKI <amotoki@gmail.com>
  45 .\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
  46 .\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
  47 .\"
  48 .TH SCHED_SETSCHEDULER 2 2014\-10\-02 Linux "Linux Programmer's Manual"
  49 .SH 名前
  50 sched_setscheduler, sched_getscheduler \- スケジューリングポリシーとパラメーターを設定/取得する
  51 .SH 書式
  52 .nf
  53 \fB#include <sched.h>\fP
  54 .sp
  55 \fBint sched_setscheduler(pid_t \fP\fIpid\fP\fB, int \fP\fIpolicy\fP\fB,\fP
  56 .br
  57 \fB                       const struct sched_param *\fP\fIparam\fP\fB);\fP
  58 .sp
  59 \fBint sched_getscheduler(pid_t \fP\fIpid\fP\fB);\fP
  60 .sp
  61 .fi
  62 .SH 説明
  63 \fBsched_setscheduler\fP() システムコールは、 \fIpid\fP で指定された ID
  64 を持つスレッドのスケジューリングポリシーとスケジューリングパラメーターの両方を設定する。 \fIpid\fP が 0
  65 の場合、呼び出したスレッド自身のスケジューリングポリシーとスケジューリングパラメーターが設定される。
  66
  67 スケジューリングパラメーターは \fIparam\fP 引き数で、以下の形式の構造体へのポインターを指定する。
  68
  69 .nf
  70 .in +4n
  71 struct sched_param {
  72     ...
  73     int sched_priority;
  74     ...
  75 };
  76 .in
  77 .fi
  78
  79 現在の実装では、この構造体のフィールドは \fIsched_priority\fP だけである。 \fIparam\fP
  80 がどのように解釈されるかは選択されたポリシーによって変わる。
  81
  82 現在のところ、 Linux では、 以下の「通常」の (つまり、リアルタイムではない) スケジューリングポリシーが、 \fIpolicy\fP
  83 に指定できる値としてサポートされている。
  84 .TP  14
  85 \fBSCHED_OTHER\fP
  86 .\" In the 2.6 kernel sources, SCHED_OTHER is actually called
  87 .\" SCHED_NORMAL.
  88 標準の、ラウンドロビンによる時分割型のスケジューリングポリシー。
  89 .TP
  90 \fBSCHED_BATCH\fP
  91 「バッチ」形式でのプロセスの実行用。
  92 .TP
  93 \fBSCHED_IDLE\fP
  94 「非常に」低い優先度で動作するバックグラウンドジョブ用。
  95 .PP
  96 上記のどのポリシーの場合でも、 \fIparam\->sched_priority\fP は 0 でなければならない。
  97
  98 どの実行可能スレッドを選択するかについて、より正確な制御を必要とする 時間の制約が厳しい特別なアプリケーション用として、
  99 いろいろな「リアルタイム」ポリシーもサポートされている。 プロセスがこれらのポリシーをいつ使用できるかを決めるルールについては、\fBsched\fP(7)
 100 を参照。 \fIpolicy\fP には以下のリアルタイムポリシーを指定できる。
 101 .TP  14
 102 \fBSCHED_FIFO\fP
 103 ファーストイン、ファーストアウト型のポリシー。
 104 .TP
 105 \fBSCHED_RR\fP
 106 ラウンドロビン型のポリシー。
 107 .PP
 108 上記のどのポリシーの場合でも、 \fIparam\->sched_priority\fP はそのスレッドのスケジューリングポリシーを指定する。
 109 指定された \fIpolicy\fP で \fIsched_get_priority_min\fP(2) と
 110 \fIsched_get_priority_max\fP(2) を呼び出した返り値の範囲の数字を指定する。 Linux では、これらのシステムコールはそれぞれ
 111 1 と 99 を返す。
 112
 113 Linux 2.6.32 以降では、 \fBsched_setscheduler\fP() を呼び出す際に \fIpolicy\fP に
 114 \fBSCHED_RESET_ON_FORK\fP フラグを OR で指定できる。このフラグが指定されると、 \fBfork\fP(2)
 115 で作成された子プロセスは特権が必要なスケジューリングポリシーを継承しない。 詳細は \fBsched\fP(7) を参照。
 116
 117 \fBsched_getscheduler\fP()  は \fIpid\fP で識別されるスレッドの現在のスケジューリングポリシーを返す。\fIpid\fP が 0
 118 ならば、呼び出した スレッド自身のスケジューリングポリシーが返される。
 119 .SH 返り値
 120 成功した場合、 \fBsched_setscheduler\fP()  は 0 を返す。 成功した場合、 \fBsched_getscheduler\fP()
 121 は現在のそのスレッドのポリシー (非負の整数) を返す。 エラーの場合、 どちらのコールも \-1 を返し、 \fIerrno\fP が適切に設定される。
 122 .SH エラー
 123 .TP
 124 \fBEINVAL\fP
 125 無効な引き数: \fIpid\fP が負である、または \fIparam\fP が NULL である。
 126 .TP
 127 \fBEINVAL\fP
 128 (\fBsched_setscheduler\fP()) \fIpolicy\fP が認識できるポリシーではない。
 129 .TP
 130 \fBEINVAL\fP
 131 (\fBsched_setscheduler\fP()) 引き数 \fIparam\fP が指定された \fIpolicy\fP では意味を持たない。
 132 .TP
 133 \fBEPERM\fP
 134 呼び出したスレッドが適切な特権を持っていない。
 135 .TP
 136 \fBESRCH\fP
 137 ID が \fIpid\fP のスレッドが見つからなかった。
 138 .SH 準拠
 139 POSIX.1\-2001 (但し、下記のバグの節も参照)。 \fBSCHED_BATCH\fP と \fBSCHED_IDLE\fP ポリシーは Linux
 140 固有である。
 141 .SH 注意
 142 上記の「通常」および「リアルタイム」スケジューリングポリシーの動作の詳細な説明は \fBsched\fP(7) にある。
 143
 144 POSIX システムでは \fI<unistd.h>\fP に \fB_POSIX_PRIORITY_SCHEDULING\fP
 145 が定義されている場合にのみ \fBsched_setscheduler\fP()  と \fBsched_getscheduler\fP()  が使用できる。
 146
 147 POSIX.1 は、非特権スレッドが \fBsched_setscheduler\fP()  を呼び出すために必要な権限の詳細を規定しておらず、
 148 詳細はシステムにより異なる。 例えば、Solaris 7 のマニュアルページでは、 呼び出し元の実ユーザー ID または実効ユーザー ID が
 149 設定対象の実ユーザー ID か保存 (save) set\-user\-ID と 一致していなければならない、となっている。
 150 .PP
 151 Linux では、 スケジューリングポリシーとスケジューリングパラメーターは、 実際にはスレッド単位の属性である。 \fBgettid\fP(2)
 152 の呼び出しの返り値をこのシステムコールの \fIpid\fP 引き数として渡すことができる。 \fIpid\fP に 0 を指定すると、
 153 呼び出し元のスレッドの属性が設定される。 \fBgetpid\fP(2) コールからの返り値を \fIpid\fP に指定すると、
 154 スレッドグループのメインスレッドの属性が設定される (POSIX スレッド API を使用している場合は、 \fBsched_*\fP(2)
 155 システムコールの代わりに \fBpthread_setschedparam\fP(3), \fBpthread_getschedparam\fP(3), and
 156 \fBpthread_setschedprio\fP(3) を使用すること)。
 157 .SH バグ
 158 POSIX では、成功時に \fBsched_setscheduler\fP()  は直前のスケジューリングポリシーを返すべきとされている。 Linux の
 159 \fBsched_setscheduler\fP()  はこの要求仕様に準拠しておらず、 成功時には常に 0 を返す。
 160 .SH 関連項目
 161 .ad l
 162 .nh
 163 \fBchrt\fP(1), \fBnice\fP(2), \fBsched_get_priority_max\fP(2),
 164 \fBsched_get_priority_min\fP(2), \fBsched_getaffinity\fP(2), \fBsched_getattr\fP(2),
 165 \fBsched_getparam\fP(2), \fBsched_rr_get_interval\fP(2), \fBsched_setaffinity\fP(2),
 166 \fBsched_setattr\fP(2), \fBsched_setparam\fP(2), \fBsched_yield\fP(2),
 167 \fBsetpriority\fP(2), \fBcapabilities\fP(7), \fBcpuset\fP(7), \fBsched\fP(7)
 168 .ad
 169 .SH この文書について
 170 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 171 である。プロジェクトの説明とバグ報告に関する情報は
 172 http://www.kernel.org/doc/man\-pages/ に書かれている。