OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man2 / adjtimex.2
index bbb2abb..f3c3d4d 100644 (file)
 .\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl>
 .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
-.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
-.\"         all rights reserved.
-.\" Translated 1997-12-17, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated and Modified 2001-06-12,Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated and Modified 2004-12-28, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2006-07-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.34
+.\"*******************************************************************
 .\"
-.\"WORD:       kernel                  カーネル
-.\"WORD:       algorithm               アルゴリズム
-.\"WORD:       update                  更新
-.\"WORD:       parameter               パラメーター
-.\"WORD:       field                   フィールド
-.\"WORD:       super user              スーパー・ユーザー
-.\"WORD:       timer                   タイマー
-.\"WORD:       interrupt               割り込み
-.\"WORD:       memory                  メモリ
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH ADJTIMEX 2 2004-05-27 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH ADJTIMEX 2 2004\-05\-27 Linux "Linux Programmer's Manual"
 .SH 名前
 adjtimex \- カーネルの時計を調整する
 .SH 書式
-.B #include <sys/timex.h>
+\fB#include <sys/timex.h>\fP
 .sp
-.BI "int adjtimex(struct timex *" "buf" );
+\fBint adjtimex(struct timex *\fP\fIbuf\fP\fB);\fP
 .SH 説明
-Linux は David L. Mill の時計調節アルゴリズムを使用している
-(RFC\ 1305 を参照)。
-システムコール
-.BR adjtimex ()
-はこのアルゴリズムの調節のパラメーターを読み取ったり、設定したりする。
-この関数は
-.I timex
-構造体へのポインターを受け取り、その値でカーネルのパラメーターを更新して、
-同じ構造体に現在のカーネルの値を返す。
-この構造体は以下のように宣言される:
+Linux は David L. Mill の時計調節アルゴリズムを使用している (RFC\ 1305 を参照)。 システムコール
+\fBadjtimex\fP()  はこのアルゴリズムの調節のパラメーターを読み取ったり、設定したりする。 この関数は \fItimex\fP
+構造体へのポインターを受け取り、その値でカーネルのパラメーターを更新して、 同じ構造体に現在のカーネルの値を返す。 この構造体は以下のように宣言される:
 .PP
 .in +4n
 .nf
+.\" FIXME -- what is the scaling unit?  2^16 ?
 struct timex {
     int modes;           /* mode selector */
     long offset;         /* time offset (usec) */
     long freq;           /* frequency offset (scaled ppm) */
-.\" FIXME -- what is the scaling unit?  2^16 ?
     long maxerror;       /* maximum error (usec) */
     long esterror;       /* estimated error (usec) */
     int status;          /* clock command/status */
     long constant;       /* pll time constant */
-    long precision;      /* clock precision (usec) (read-only) */
+    long precision;      /* clock precision (usec) (read\-only) */
     long tolerance;      /* clock frequency tolerance (ppm)
-                            (read-only) */
-    struct timeval time; /* current time (read-only) */
+                            (read\-only) */
+    struct timeval time; /* current time (read\-only) */
     long tick;           /* usecs between clock ticks */
 };
 .fi
 .in
 .PP
-.I modes
-フィールドは (必要に応じて) どのパラメーターを設定するか決定する。
-それは以下のビット値の 0 個以上の
-.RI "ビット " OR
+\fImodes\fP フィールドは (必要に応じて) どのパラメーターを設定するか決定する。 それは以下のビット値の 0 個以上の ビット \fIOR\fP
 からなる:
 .PP
 .in +4n
@@ -97,21 +75,15 @@ struct timex {
 #define ADJ_STATUS            0x0010 /* clock status */
 #define ADJ_TIMECONST         0x0020 /* pll time constant */
 #define ADJ_TICK              0x4000 /* tick value */
-#define ADJ_OFFSET_SINGLESHOT 0x8001 /* old-fashioned adjtime() */
+#define ADJ_OFFSET_SINGLESHOT 0x8001 /* old\-fashioned adjtime() */
 .fi
 .in
 .PP
-通常のユーザーは
-.I mode
-の値は 0 に制限されている。
-スーパー・ユーザーのみが全てのパラメーターを設定できる。
+通常のユーザーは \fImode\fP の値は 0 に制限されている。 スーパー・ユーザーのみが全てのパラメーターを設定できる。
 .br
 .ne 12v
 .SH 返り値
-成功した場合、
-.BR adjtimex ()
-は
-クロックの状態を返す:
+成功した場合、 \fBadjtimex\fP()  は クロックの状態を返す:
 .PP
 .in +4n
 .nf
@@ -123,48 +95,22 @@ struct timex {
 .fi
 .in
 .PP
-失敗した場合は
-.BR adjtimex ()
-は \-1 を返し、
-.I errno
-が設定される。
+失敗した場合は \fBadjtimex\fP()  は \-1 を返し、 \fIerrno\fP が設定される。
 .SH エラー
-.TP
-.B EFAULT
-.I buf
-が書き込み可能なメモリを指していない。
-.TP
-.B EINVAL
-.I buf.offset
-へ \-131071 〜 +131071 の範囲以外の値を設定しようとしたか、
-.I buf.status
-に上記以外の値を設定しようとしたか、
-.I buf.tick
-に
-.RB 900000/ HZ
-〜
-.RB 1100000/ HZ
-の範囲以外の値を設定しようとした。
-ここで
-.B HZ
-はシステムのタイマー割り込みの周期である。
-.TP
-.B EPERM
-.I buf.mode
-が 0 でなく、かつ呼び出し元が十分な特権を持っていない。
-Linux では
-.B CAP_SYS_TIME
+.TP 
+\fBEFAULT\fP
+\fIbuf\fP が書き込み可能なメモリを指していない。
+.TP 
+\fBEINVAL\fP
+\fIbuf.offset\fP へ \-131071 〜 +131071 の範囲以外の値を設定しようとしたか、 \fIbuf.status\fP
+に上記以外の値を設定しようとしたか、 \fIbuf.tick\fP に 900000/\fBHZ\fP 〜 1100000/\fBHZ\fP
+の範囲以外の値を設定しようとした。 ここで \fBHZ\fP はシステムのタイマー割り込みの周期である。
+.TP 
+\fBEPERM\fP
+\fIbuf.mode\fP が 0 でなく、かつ呼び出し元が十分な特権を持っていない。 Linux では \fBCAP_SYS_TIME\fP
 ケーパビリティが必要である。
 .SH 準拠
-.BR adjtimex ()
-は Linux 特有であり、
-移植を意図したプログラムで使用すべきではない。
-システムクロックを調整する方法で、
-移植性があるが自由度は劣る方法については
-.BR adjtime (3)
-を参照のこと。
+\fBadjtimex\fP()  は Linux 特有であり、 移植を意図したプログラムで使用すべきではない。 システムクロックを調整する方法で、
+移植性があるが自由度は劣る方法については \fBadjtime\fP(3)  を参照のこと。
 .SH 関連項目
-.BR settimeofday (2),
-.BR adjtime (3),
-.BR capabilities (7),
-.BR time (7)
+\fBsettimeofday\fP(2), \fBadjtime\fP(3), \fBcapabilities\fP(7), \fBtime\fP(7)