.\" 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) 2006 Akihiro MOTOKI all rights reserved.
-.\" Translated 2006-07-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"*******************************************************************
.\"
-.TH ADJTIME 3 2008-06-22 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH ADJTIME 3 2008\-06\-22 Linux "Linux Programmer's Manual"
.SH 名前
adjtime \- システムクロックに同期する時刻を調整する
.SH 書式
.nf
-.BI "int adjtime(const struct timeval *" delta ", struct timeval *" olddelta );
+\fBint adjtime(const struct timeval *\fP\fIdelta\fP\fB, struct timeval *\fP\fIolddelta\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR adjtime ():
-_BSD_SOURCE
+\fBadjtime\fP(): _BSD_SOURCE
.SH 説明
-.BR adjtime ()
-関数は
-.RB ( gettimeofday (2)
-が返す) システムクロックを徐々に調整する。
-調整すべきクロックの時間量は
-.I delta
-が指す構造体で指定される。
-この構造体は以下の形である:
+\fBadjtime\fP() 関数は (\fBgettimeofday\fP(2) が返す) システムクロックを徐々に調整する。 調整すべきクロックの時間量は
+\fIdelta\fP が指す構造体で指定される。 この構造体は以下の形である:
.in +4n
.nf
.fi
.in
.PP
-.I delta
-の調整量が正の場合、調整量に達するまでシステムクロックを
-少し割合だけスピードアップさせる (つまり、毎秒クロック値に少しだけ
-時刻を加算する)。
-.I delta
-の調整量が負の場合、同様の方法でクロックを遅くする。
+\fIdelta\fP の調整量が正の場合、調整量に達するまでシステムクロックを 少し割合だけスピードアップさせる (つまり、毎秒クロック値に少しだけ
+時刻を加算する)。 \fIdelta\fP の調整量が負の場合、同様の方法でクロックを遅くする。
-.BR adjtime ()
-が呼び出されたときに以前の
-.BR adjtime ()
-の呼び出しによるクロックの調整がまだ実行中で、かつ後の
-.BR adjtime ()
-の
-.I delta
-が NULL でない場合、実行中の調整は停止される。
+\fBadjtime\fP() が呼び出されたときに以前の \fBadjtime\fP() の呼び出しによるクロックの調整がまだ実行中で、かつ後の
+\fBadjtime\fP() の \fIdelta\fP が NULL でない場合、実行中の調整は停止される。
しかし、すでに実行された調整の取り消しは行われない。
-.I olddelta
-が NULL でない場合、
-.I olddelta
-が指すバッファに、過去の調整要求でまだ完了せず残っている時間量が
+\fIolddelta\fP が NULL でない場合、 \fIolddelta\fP が指すバッファに、過去の調整要求でまだ完了せず残っている時間量が
格納して返される。
.SH 返り値
-成功すると、
-.BR adjtime ()
-は 0 を返す。失敗すると、\-1 を返し、
-.I errno
-にエラーを示す値をセットする。
+成功すると、 \fBadjtime\fP() は 0 を返す。失敗すると、\-1 を返し、 \fIerrno\fP にエラーを示す値をセットする。
.SH エラー
-.TP
-.B EINVAL
-.I delta
-で指定された調整量が許可された範囲に入っていない。
-.TP
-.B EPERM
-呼び出し者が時刻を調整するのに必要な権限を持っていない。
-Linux では
-.B CAP_SYS_TIME
-ケーパビリティが必要である。
+.TP
+\fBEINVAL\fP
+\fIdelta\fP で指定された調整量が許可された範囲に入っていない。
+.TP
+\fBEPERM\fP
+呼び出し者が時刻を調整するのに必要な権限を持っていない。 Linux では \fBCAP_SYS_TIME\fP ケーパビリティが必要である。
.SH 準拠
4.3BSD, System V.
.SH 注意
-.BR adjtime ()
-が行うクロックの調整は、クロックは常に単調増加するという範囲内で
-実行される。
-.BR adjtime ()
-を使って時刻を調整することで、システムタイムの突然の正や負のジャンプ
-により、いくつかのアプリケーション (例えば
-.BR make (1)
-など) に起こる問題を防ぐことができる。
+\fBadjtime\fP() が行うクロックの調整は、クロックは常に単調増加するという範囲内で 実行される。 \fBadjtime\fP()
+を使って時刻を調整することで、システムタイムの突然の正や負のジャンプ により、いくつかのアプリケーション (例えば \fBmake\fP(1) など)
+に起こる問題を防ぐことができる。
-.BR adjtime ()
-はシステム時刻に少しずつ調整を行うために使用されることを期待されている。
-ほとんどのシステムでは、
-.I delta
-に指定できる調整量に制限を課している。
-glibc の実装では、
-.I delta
-は (INT_MIN / 1000000 + 2) 以上 (INT_MAX / 1000000 \- 2) 以下
-(i386 では \-2145 以上 2145 以下) でなければならない。
+\fBadjtime\fP() はシステム時刻に少しずつ調整を行うために使用されることを期待されている。 ほとんどのシステムでは、 \fIdelta\fP
+に指定できる調整量に制限を課している。 glibc の実装では、 \fIdelta\fP は (INT_MIN / 1000000 + 2) 以上
+(INT_MAX / 1000000 \- 2) 以下 (i386 では \-2145 以上 2145 以下) でなければならない。
.SH バグ
-ずっと昔から、
.\" http://sourceware.org/bugzilla/show_bug?id=2449
.\" http://bugzilla.kernel.org/show_bug.cgi?id=6761
-.I delta
-に NULL を指定すると、未完了のクロック調整に関する有効な情報が
-.I olddelta
-に返されないというバグがあった (この場合、
-.BR adjtime ()
-は、未完了のクロック調整に関する情報を、変更せずに返すべきである)。
-このバグは、
-.\" adjtimex() の新しいフラグ ADJ_OFFSET_SS_READ のおかげだ。
-glibc 2.8 以降で、Linux カーネル 2.6.26 以降のシステムで修正されている。
+.\" Thanks to the new adjtimex() ADJ_OFFSET_SS_READ flag
+ずっと昔から、 \fIdelta\fP に NULL を指定すると、未完了のクロック調整に関する有効な情報が \fIolddelta\fP
+に返されないというバグがあった (この場合、 \fBadjtime\fP() は、未完了のクロック調整に関する情報を、変更せずに返すべきである)。
+このバグは、 glibc 2.8 以降で、Linux カーネル 2.6.26 以降のシステムで修正されている。
.SH 関連項目
-.BR adjtimex (2),
-.BR gettimeofday (2),
-.BR time (7)
+\fBadjtimex\fP(2), \fBgettimeofday\fP(2), \fBtime\fP(7)
OSDN Git Service
