ADJTIME

名前

書式

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

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

adjtime(): _BSD_SOURCE  

説明

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

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

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

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

返り値

エラー

EINVAL

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

EPERM

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

準拠

注意

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

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

注意

関連項目