.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 2008 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated 2008-08-21, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.04
-.\"
-.TH CLOCK_NANOSLEEP 2 2010-12-03 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH CLOCK_NANOSLEEP 2 2010\-12\-03 Linux "Linux Programmer's Manual"
.SH 名前
clock_nanosleep \- 指定したクロックでの高精度な実行停止 (sleep)
.SH 書式
-.B #include <time.h>
+\fB#include <time.h>\fP
.nf
.sp
-.BI "int clock_nanosleep(clockid_t " clock_id ", int " flags ,
-.BI " const struct timespec *" request ,
-.BI " struct timespec *" remain );
+\fBint clock_nanosleep(clockid_t \fP\fIclock_id\fP\fB, int \fP\fIflags\fP\fB,\fP
+\fB const struct timespec *\fP\fIrequest\fP\fB,\fP
+\fB struct timespec *\fP\fIremain\fP\fB);\fP
.fi
.sp
\fI\-lrt\fP でリンクする。
.sp
.ad l
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR clock_nanosleep ():
+\fBclock_nanosleep\fP():
.RS 4
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
.RE
.ad
.SH 説明
-.BR clock_nanosleep ()
-を使うと、
-.BR nanosleep (2)
-同様、ナノ秒の精度で指定された期間だけ呼び出したスレッドの実行を
-停止することができる。
-.BR nanosleep (2)
-と違うのは、呼び出し側が停止期間をどのクロックに対して計測するのかを選択
-できる点と、停止期間を絶対値でも相対値でも指定できる点である。
+\fBclock_nanosleep\fP() を使うと、 \fBnanosleep\fP(2)
+同様、ナノ秒の精度で指定された期間だけ呼び出したスレッドの実行を 停止することができる。 \fBnanosleep\fP(2)
+と違うのは、呼び出し側が停止期間をどのクロックに対して計測するのかを選択 できる点と、停止期間を絶対値でも相対値でも指定できる点である。
-このシステムコールに渡したり、このシステムコールが返したりする時間の値は
-.I timespec
+このシステムコールに渡したり、このシステムコールが返したりする時間の値は \fItimespec\fP
構造体を使って指定される。この構造体の定義は以下の通りである。
.sp
.in +4n
.fi
.in
-.I clock_id
-引き数で、停止期間をどのクロックに対して計測するかを指定する。
-この引き数には以下の値のいずれか一つを指定できる。
-.TP 17
-.BR CLOCK_REALTIME
-システム全体で使われる実時間クロック。
-このクロックは変更可能である。
-.TP
-.BR CLOCK_MONOTONIC
-過去のある時点からの時間を計測する、単調増加のクロック。
-起点となる時点はシステム起動後には変更されない。
-このクロックは変更することができない。
-.\" Linux では、このクロックは起動からの時間を計測する。
-.TP
-.BR CLOCK_PROCESS_CPUTIME_ID
-そのプロセスの全スレッドで消費される CPU 時間を計測するプロセス単位の
-クロック。このクロックは設定可能である。
+\fIclock_id\fP 引き数で、停止期間をどのクロックに対して計測するかを指定する。 この引き数には以下の値のいずれか一つを指定できる。
+.TP 17
+\fBCLOCK_REALTIME\fP
+システム全体で使われる実時間クロック。 このクロックは変更可能である。
+.TP
+\fBCLOCK_MONOTONIC\fP
+.\" On Linux this clock measures time since boot.
+過去のある時点からの時間を計測する、単調増加のクロック。 起点となる時点はシステム起動後には変更されない。 このクロックは変更することができない。
+.TP
+\fBCLOCK_PROCESS_CPUTIME_ID\fP
.\" There is some trickery between glibc and the kernel
.\" to deal with the CLOCK_PROCESS_CPUTIME_ID case.
+そのプロセスの全スレッドで消費される CPU 時間を計測するプロセス単位の クロック。このクロックは設定可能である。
.PP
-これらのクロックの詳細については
-.BR clock_getres (2)
-を参照。
+これらのクロックの詳細については \fBclock_getres\fP(2) を参照。
-.I flags
-が 0 の場合、
-.I request
-に指定された値は
-.I clock_id
+\fIflags\fP が 0 の場合、 \fIrequest\fP に指定された値は \fIclock_id\fP
で指定されたクロックの現在の値からの相対的な期間と解釈される。
-.I flags
-が
-.B TIMER_ABSTIME
-の場合、
-.I request
-は指定されたクロックで計測される絶対時刻と解釈される。
-.I request
-が指定されたクロックの現在の値以下の場合、
-.BR clock_nanosleep ()
+\fIflags\fP が \fBTIMER_ABSTIME\fP の場合、 \fIrequest\fP は指定されたクロックで計測される絶対時刻と解釈される。
+\fIrequest\fP が指定されたクロックの現在の値以下の場合、 \fBclock_nanosleep\fP()
は、呼び出したスレッドの停止を行わず、すぐに返る。
-.BR clock_nanosleep ()
-は、少なくとも
-.I request
-で指定された時間が経過するまで、呼び出したスレッドの実行を停止する。
-シグナルハンドラが呼び出されたり、そのプロセスを終了させるような
-シグナルが配送されたりした場合にも、スレッドの実行停止は終了する。
+\fBclock_nanosleep\fP() は、少なくとも \fIrequest\fP で指定された時間が経過するまで、呼び出したスレッドの実行を停止する。
+シグナルハンドラが呼び出されたり、そのプロセスを終了させるような シグナルが配送されたりした場合にも、スレッドの実行停止は終了する。
-呼び出しがシグナルハンドラによって割り込まれた場合、
-.BR clock_nanosleep ()
-はエラー
-.B EINTR
-で失敗する。さらに、
-.I remain
-が NULL でなく、かつ
-.I flags
-が
-.B TIMER_ABSTIME
-でない場合には、
-.I remain
-に残りの停止時間が返される。
-この値を使って
-.BR clock_nanosleep ()
-を再度呼び出すことで、(相対的な期間の) 停止を完了することができる。
+呼び出しがシグナルハンドラによって割り込まれた場合、 \fBclock_nanosleep\fP() はエラー \fBEINTR\fP で失敗する。さらに、
+\fIremain\fP が NULL でなく、かつ \fIflags\fP が \fBTIMER_ABSTIME\fP でない場合には、 \fIremain\fP
+に残りの停止時間が返される。 この値を使って \fBclock_nanosleep\fP() を再度呼び出すことで、(相対的な期間の)
+停止を完了することができる。
.SH 返り値
-要求された期間の停止に成功すると、
-.BR clock_nanosleep ()
-は 0 を返す。
-シグナルハンドラで割り込まれたり、エラーが発生したりした場合、
-「エラー」の節のリストにある正のエラー番号のいずれか一つを返す。
+要求された期間の停止に成功すると、 \fBclock_nanosleep\fP() は 0 を返す。
+シグナルハンドラで割り込まれたり、エラーが発生したりした場合、 「エラー」の節のリストにある正のエラー番号のいずれか一つを返す。
.SH エラー
-.TP
-.B EFAULT
-.I request
-や
-.I remain
-に無効なアドレスが指定された。
-.TP
-.B EINTR
+.TP
+\fBEFAULT\fP
+\fIrequest\fP や \fIremain\fP に無効なアドレスが指定された。
+.TP
+\fBEINTR\fP
停止がシグナルハンドラにより割り込まれた。
-.TP
-.B EINVAL
-.I tv_nsec
-フィールドの値が 0 から 999999999 の範囲でないか、
-.I tv_sec
-の値が負であった。
-.TP
-.B EINVAL
-.I clock_id
-が無効であった
-.RB ( CLOCK_THREAD_CPUTIME_ID
-が
-.I clock_id
-として有効な値ではない)。
+.TP
+\fBEINVAL\fP
+\fItv_nsec\fP フィールドの値が 0 から 999999999 の範囲でないか、 \fItv_sec\fP の値が負であった。
+.TP
+\fBEINVAL\fP
+\fIclock_id\fP が無効であった (\fBCLOCK_THREAD_CPUTIME_ID\fP が \fIclock_id\fP として有効な値ではない)。
.SH バージョン
-.BR clock_nanosleep ()
-システムコールは Linux 2.6 で初めて登場した。
-glibc ではバージョン 2.1 以降でサポートされている。
+\fBclock_nanosleep\fP() システムコールは Linux 2.6 で初めて登場した。 glibc ではバージョン 2.1
+以降でサポートされている。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
.SH 注意
-.I request
-で指定された停止期間が、時間の計測に使用されるクロック
-.RB ( time (7)
-参照) の精度の倍数ちょうどでない場合、停止期間は一番近い次の倍数に
-切り上げられる。さらに、停止が完了した後に、CPU が呼び出したスレッドを
+\fIrequest\fP で指定された停止期間が、時間の計測に使用されるクロック (\fBtime\fP(7) 参照)
+の精度の倍数ちょうどでない場合、停止期間は一番近い次の倍数に 切り上げられる。さらに、停止が完了した後に、CPU が呼び出したスレッドを
もう一度実行できるようになるまでには、遅延が入る可能性がある。
-絶対値指定のタイマを使うのは、
-.BR nanosleep (2)
-に書かれている類のタイマのずれの問題を防止するのに役立つ
-(この種の問題は、シグナルに割り込まれた際に相対指定の停止を
-繰り返し再開しようとするプログラムでは、かえって悪化する)。
-これらの問題を回避して相対指定の停止を実行するには、
-希望するクロックで
-.BR clock_gettime (2)
-を呼び出し、その返り値の時刻値に希望する期間を加算してから、
-.B TIMER_ABSTIME
-フラグを指定して
-.BR clock_nanosleep ()
-を呼び出す。
+絶対値指定のタイマを使うのは、 \fBnanosleep\fP(2) に書かれている類のタイマのずれの問題を防止するのに役立つ
+(この種の問題は、シグナルに割り込まれた際に相対指定の停止を 繰り返し再開しようとするプログラムでは、かえって悪化する)。
+これらの問題を回避して相対指定の停止を実行するには、 希望するクロックで \fBclock_gettime\fP(2)
+を呼び出し、その返り値の時刻値に希望する期間を加算してから、 \fBTIMER_ABSTIME\fP フラグを指定して
+\fBclock_nanosleep\fP() を呼び出す。
-.BR sigaction (2)
-で
-.BR SA_RESTART
-フラグが指定されているかに関わらず、
-シグナルハンドラにより割り込まれた後に
-.BR clock_nanosleep ()
-が再開されることは決してない。
+\fBsigaction\fP(2) で \fBSA_RESTART\fP フラグが指定されているかに関わらず、 シグナルハンドラにより割り込まれた後に
+\fBclock_nanosleep\fP() が再開されることは決してない。
-.I flags
-が
-.B TIMER_ABSTIME
-の場合、
-.I remain
-引き数は使用されず、不要である
-(絶対値での停止では、同じ
-.I request
-引き数を使って再度呼び出すことができる)。
+\fIflags\fP が \fBTIMER_ABSTIME\fP の場合、 \fIremain\fP 引き数は使用されず、不要である (絶対値での停止では、同じ
+\fIrequest\fP 引き数を使って再度呼び出すことができる)。
-POSIX.1 の規定では、
-.BR clock_nanosleep ()
-はシグナルの処理方法やシグナルマスクに影響を与えない、とされている。
+POSIX.1 の規定では、 \fBclock_nanosleep\fP() はシグナルの処理方法やシグナルマスクに影響を与えない、とされている。
-POSIX.1 の規定では、
-.BR clock_settime (2)
-で
-.B CLOCK_REALTIME
-クロックの値を変更した後は、絶対値指定の
-.BR clock_nanosleep ()
-で停止しているスレッドを起動させる時刻の判定は、
-新しいクロック値を使って行われる、とされている。
-新しいクロック値において停止期間の終了時刻が過去になってしまった場合には、
-.BR clock_nanosleep ()
-はすぐに返ることになる。
+POSIX.1 の規定では、 \fBclock_settime\fP(2) で \fBCLOCK_REALTIME\fP クロックの値を変更した後は、絶対値指定の
+\fBclock_nanosleep\fP() で停止しているスレッドを起動させる時刻の判定は、 新しいクロック値を使って行われる、とされている。
+新しいクロック値において停止期間の終了時刻が過去になってしまった場合には、 \fBclock_nanosleep\fP() はすぐに返ることになる。
-POSIX.1 の規定では、
-.BR clock_settime (2)
-で
-.B CLOCK_REALTIME
-クロックの値を変更しても、相対値指定の
-.BR clock_nanosleep ()
-で停止しているスレッドには影響を与えない、とされている。
+POSIX.1 の規定では、 \fBclock_settime\fP(2) で \fBCLOCK_REALTIME\fP クロックの値を変更しても、相対値指定の
+\fBclock_nanosleep\fP() で停止しているスレッドには影響を与えない、とされている。
.SH 関連項目
-.BR clock_getres (2),
-.BR nanosleep (2),
-.BR timer_create (2),
-.BR sleep (3),
-.BR usleep (3),
-.BR time (7)
+\fBclock_getres\fP(2), \fBnanosleep\fP(2), \fBtimer_create\fP(2), \fBsleep\fP(3),
+\fBusleep\fP(3), \fBtime\fP(7)
OSDN Git Service
