sched_rr_get_intervalのヘルプ・マニュアル
日本語 英語
sched_rr_get_interval --help
man sched_rr_get_interval
SCHED_RR_GET_INTERVAL(2) Linux Programmer’s Manual SCHED_RR_GET_INTERVAL(2)
名前
sched_rr_get_interval - 指定されたプロセスの SCHED_RR 間隔を取得する
書式
#include
int sched_rr_get_interval(pid_t pid, struct timespec *tp);
説明
sched_rr_get_interval() は tp で指定された timespec 構造体に pid で指定
されたプロセスのラウンド・ロビン時間量 (round robin time quantum) を 書
き込む。
timespec 構造体は以下の通りである:
struct timespec {
time_t tv_sec; /* seconds */
long tv_nsec; /* nanoseconds */
};
pid がゼロの場合、呼び出したプロセスの時間量が *tp に書き込まれる。指定
したプロセスは SCHED_RR スケジューリング方針で稼動している必要がある 。
sched_rr_get_interval() の使用可能な POSIX システムでは で
_POSIX_PRIORITY_SCHEDULING が定義されている。
返り値
成功した場合は sched_rr_get_interval() は 0 を返す。エラーの場合 は -1
が返され、 errno が適切に設定される。
エラー
EFAULT 情報をユーザ空間にコピーする時に問題が起きた。
EINVAL PID が不正である。
ENOSYS システム・コールがまだ実装されていない (かなり古いカーネルにおい
てのみ)。
ESRCH pid の ID を持つプロセスが見つからなかった。
準拠
POSIX.1-2001.
注意
Linux での注意
POSIX ではラウンド・ロビン時間量の大きさを制御する仕組みが規定されて い
な い。しかし、Linux ではこれを変更する方法が提供されており (この方法に
移植性はない)、プロセスの nice 値を調整することで時間量を制 御 で き る
(setpriority(2) 参照)。負の nice 値 (すなわち、高い nice 値) を割り当て
ると時間量は長くなり、正の nice 値 (すなわち、低い nice 値) を割り当 て
ると時間量は短くなる。デフォルトの時間量は 0.1 秒である。 nice 値の変更
が時間量にどの程度影響を与えるかはカーネルのバージョンにより多少異な る
。
関連項目
sched_setscheduler(2) に Linux のスケジューリング方式についての説明があ
る。
Programming for the real world - POSIX.4 by Bill O. Gallmeister,
O’Reilly & Associates, Inc., ISBN 1-56592-074-0
Linux 2007-04-06 SCHED_RR_GET_INTERVAL(2)
SCHED_RR_GET_INTERVAL(2) Linux Programmer’s Manual SCHED_RR_GET_INTERVAL(2)
NAME
sched_rr_get_interval - get the SCHED_RR interval for the named process
SYNOPSIS
#include
int sched_rr_get_interval(pid_t pid, struct timespec * tp);
DESCRIPTION
sched_rr_get_interval() writes into the timespec structure pointed to
by tp the round-robin time quantum for the process identified by pid.
The timespec structure has the following form:
struct timespec {
time_t tv_sec; /* seconds */
long tv_nsec; /* nanoseconds */
};
If pid is zero, the time quantum for the calling process is written
into *tp. The identified process should be running under the SCHED_RR
scheduling policy. POSIX systems on which sched_rr_get_interval() is
available define _POSIX_PRIORITY_SCHEDULING in .
RETURN VALUE
On success, sched_rr_get_interval() returns 0. On error, -1 is
returned, and errno is set appropriately.
ERRORS
EFAULT Problem with copying information to userspace.
EINVAL Invalid pid.
ENOSYS The system call is not yet implemented (only on rather old ker-
nels).
ESRCH The process whose ID is pid could not be found.
CONFORMING TO
POSIX.1-2001.
NOTES
Linux Notes
POSIX does not specify any mechanism for controlling the size of the
round-robin time quantum. However, Linux provides a (non-portable)
method of doing this. The quantum can be controlled by adjusting the
process’s nice value (see setpriority(2)). Assigning a negative (i.e.,
high) nice value results in a longer quantum; assigning a positive
(i.e., low) nice value results in a shorter quantum. The default quan-
tum is 0.1 seconds; the degree to which changing the nice value affects
the quantum has varied somewhat across kernel versions.
SEE ALSO
sched_setscheduler(2) has a description of the Linux scheduling scheme.
Programming for the real world - POSIX.4 by Bill O. Gallmeister,
O’Reilly & Associates, Inc., ISBN 1-56592-074-0
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2007-04-06 SCHED_RR_GET_INTERVAL(2)