adjtime

adjtime是一個調用按時間值delta來微調系統時間的計算機函式。

頭檔案

#include <sys/time.h>

函式原型

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

說明

adjtime()系統調用按時間值delta來微調系統時間（比如gettimeofday(2)返回的時間）。 若delta為負，時鐘將慢走直到較正結束；若為正，時鐘將走快。通常以1%幅度來調整時鐘的走速。因此，時間的變化通常是一個單調遞增函式。當調用adjtime()後再次調用，之前調用的時間較正可能還未完成。若olddelta不為NULL，它指向的結構體在函式返回後將包含之前調用未完成的、仍須較正的微秒（百萬分之一秒）數。

該系統調用可用於時間伺服器來同步區域網路內其它計算機的時鐘。時間伺服器將調慢某些 走快的計算機，調快某些走慢的計算機，使它們同步到平均網路時間。 adjtime()系統調用只能由超級用戶調用。

返回值

執行成功時返回0，否則返回-1並設定errno來指示錯誤。

錯誤

adjtime()失敗時將設定errno為下列錯誤常量：

[EFAULT] 函式參數指向的地址超出了進程的存取空間

[EPERM] 調用者的實際或有效用戶ID不是超級用戶