adjtime

名前

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 にエラーを示す値をセットする。

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

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

インターフェース	属性	値
adjtime()	Thread safety	MT-Safe

Linux