日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
RTPRIO(2) FreeBSD システムコールマニュアル RTPRIO(2)
名称
rtprio, rtprio_thread -- リアルタイムまたはアイドルの優先順位を調査する
か、または修正する
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <sys/types.h>
#include <sys/rtprio.h>
int
rtprio(int function, pid_t pid, struct rtprio *rtp);
int
rtprio_thread(int function, lwpid_t lwpid, struct rtprio *rtp);
解説
rtprio() システムコールは、プロセスまたは呼び出しているスレッドのリアルタ
イムまたはアイドル (idle) の優先順位を検索するか、または変更するために使
用されます。rtprio_thread() システムコールは、スレッドのリアルタイムまた
はアイドルの優先順位を検索するか、または変更するために使用されます。
function 引数は、実行される操作を指定します。優先順位を検索するためには、
RTP_LOOKUP、優先順位を設定するためには、RTP_SET です。
rtprio() システムコールについて、pid 引数は、動作しているプロセスを指定
し、呼び出しているスレッドに対しては、0 を指定します。pid が 0 でないと
き、システムコールは、プロセスの最高の優先順位を報告するか、または、
function 引数の値によって、プロセス内のすべてのスレッドの優先順位を設定し
ます。
rtprio_thread() システムコールについて、lwpid は、動作しているスレッドを
指定し、呼び出しているスレッドに対しては、0 を指定します。
*rtp 引数は、優先順位と優先順位のタイプを指定する指定するために使用される
struct rtprio へのポインタです。この構造体には、次の形式があります:
struct rtprio {
u_short type;
u_short prio;
};
type フィールドの値は、リアルタイム優先順位のための RTP_PRIO_REALTIME、通
常の優先順位のための RTP_PRIO_NORMAL とアイドルの優先順位のための
RTP_PRIO_IDLE を指定できます。prio フィールドによって指定される優先順位
は、0 と RTP_PRIO_MAX (通常 31) の間の範囲です。0 は、指定できる最高の優
先順位です。
リアルタイムとアイドルの優先順位は、fork() と exec() を通して継承されま
す。
リアルタイムのスレッドは、等しいかより高い優先順のスレッド、または割り込
みによってのみ先取り (preempt) することができます。アイドルの優先順位のス
レッドは、他のリアルタイム/通常の優先順位のスレッドが実行可能でないときの
み、実行します。高いリアルタイム/アイドルの優先順位のスレッドは、低いリア
ルタイム/アイドルの優先順位のスレッドを先取り (preempt) します。等しいリ
アルタイム/アイドルの優先順位のスレッドは、ラウンドロビンで実行されます。
戻り値
関数 rtprio() および rtprio_thread() は、処理が成功すると値 0 を返しま
す。そうでない場合、値 -1 が返され、グローバル変数 errno にエラーを示す値
が設定されます。
エラー
rtprio() と rtprio_thread() システムコールは、次の場合に失敗します:
[EFAULT] rtprio() または rtprio_thread() に渡される rtp ポイン
タが、不正でした。
[EINVAL] 指定された prio が範囲外でした。
[EPERM] 呼び出しているスレッドが、リアルタイムの優先順位を設定
することができません。root だけが、任意のスレッドのリ
アルタイムの優先順位を変更することができ、root でない
ユーザは、sysctl(8) 変数
security.bsd.unprivileged_idprio が 0 以外に設定されて
いるときのみ、ユーザが所有するスレッドのアイドルの優先
順位を変更できます。
[ESRCH] 指定されたプロセスまたはスレッドが見つからないか、目に
見えませんでした。
関連項目
nice(1), ps(1), rtprio(1), setpriority(2), nice(3), renice(8),
p_cansee(9)
作者
オリジナルの作者は、Henrik Vestergaard Draboel <hvd@terry.ping.dk> でし
た。FreeBSD のこの実装は、David Greenman によって本質的に書き直されまし
た。rtprio_thread() システムコールは、David Xu によって実装されました。
FreeBSD 11.4 December 27, 2011 FreeBSD 11.4