名前

       adjtime - システムクロックに同期する時刻を調整する

書式

       #include <sys/time.h>

       int adjtime(const struct timeval *delta, struct timeval *olddelta);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       adjtime():
           Since glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 and earlier:
               _BSD_SOURCE

説明

       adjtime()   関数は (gettimeofday(2)  が返す) システムクロックを徐々に調整する。 調整すべき
       クロックの時間量は delta が指す構造体で指定される。 この構造体は以下の形である:

           struct timeval {
               time_t      tv_sec;     /* 秒 */
               suseconds_t tv_usec;    /* マイクロ秒 */
           };

       delta の調整量が正の場合、調整量に達するまでシステムクロックを  少し割合だけスピードアップ
       させる  (つまり、毎秒クロック値に少しだけ 時刻を加算する)。 delta の調整量が負の場合、同様
       の方法でクロックを遅くする。

       adjtime()  が呼び出されたときに以前の adjtime()   の呼び出しによるクロックの調整がまだ実行
       中で、かつ後の  adjtime()   の  delta  が NULL でない場合、実行中の調整は停止される。 しか
       し、すでに実行された調整の取り消しは行われない。

       olddelta が NULL  でない場合、  olddelta  が指すバッファーに、過去の調整要求でまだ完了せず
       残っている時間量が 格納して返される。

返り値

       成功すると、  adjtime()  は 0 を返す。失敗すると、-1 を返し、 errno にエラーを示す値をセッ
       トする。

エラー

       EINVAL delta で指定された調整量が許可された範囲に入っていない。

       EPERM  呼び出し者が時刻を調整するのに必要な権限を持っていない。  Linux  では  CAP_SYS_TIME
              ケーパビリティが必要である。

属性

       この節で使用されている用語の説明については、 attributes(7) を参照。

       ┌─────────────────┬───────────────┬─────────┐
       │インターフェース │ 属性          │ 値      │
       ├─────────────────┼───────────────┼─────────┤
       │adjtime()        │ Thread safety │ MT-Safe │
       └─────────────────┴───────────────┴─────────┘

準拠

       4.3BSD, System V.

注意

       adjtime()   が行うクロックの調整は、クロックは常に単調増加するという範囲内で  実行される。
       adjtime() を使って時刻を調整することで、システムタイムの突然の正や負のジャンプ  により、い
       くつかのアプリケーション (例えば make(1)  など) に起こる問題を防ぐことができる。

       adjtime()  はシステム時刻に少しずつ調整を行うために使用されることを期待されている。 ほとん
       どのシステムでは、 delta に指定できる調整量に制限を課している。 glibc  の実装では、  delta
       は (INT_MIN / 1000000 + 2) 以上 (INT_MAX / 1000000 - 2) 以下 (i386 では -2145 以上 2145 以
       下) でなければならない。

バグ

       ずっと昔から、  delta   に   NULL   を指定すると、未完了のクロック調整に関する有効な情報が
       olddelta  に返されないというバグがあった (この場合、 adjtime()  は、未完了のクロック調整に
       関する情報を、変更せずに返すべきである)。 このバグは、 glibc  2.8  以降で、Linux  カーネル
       2.6.26 以降のシステムで修正されている。

関連項目

       adjtimex(2), gettimeofday(2), time(7)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの
       説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。