ntp_gettime
Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page
名前
ntp_gettime、ntp_gettimex - 時間パラメータの取得 (NTP daemon インターフェイス)
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <sys/timex.h>
int ntp_gettime(struct ntptimeval *ntv);
int ntp_gettimex(struct ntptimeval *ntv);
説明
これらの API は両方とも、 ntv 引き数(以下のタイプの構造体)を介して呼び出し元に情報を返します。
struct ntptimeval {
struct timeval time; /* Current time */
long maxerror; /* Maximum error */
long esterror; /* Estimated error */
long tai; /* TAI offset */
/* Further padding bytes allowing for future expansion */ };
この構造体のメンバーは以下の通りです:
- time
- timeval 構造で表される現在の時刻:
- struct timeval {
time_t tv_sec; /* 紀元からの秒 */
suseconds_t tv_usec; /* マイクロ秒 */ };
- maxerror
- 最大エラーはマイクロ秒単位です。この値は ntp_adjtime(3) によって初期化され、定期的に(Linux では毎秒)増加しますが、上限はあります (カーネル定数 NTP_PHASE_MAX、値は 16000)。
- esterror
- マイクロ秒単位の推定エラー。この値には、システムクロックと実際の時刻との差の推定値を含めるように ntp_adjtime(3) を介して設定できます。この値はカーネル内部では使用されません。
- tai
- TAI (Atomic International Time) オフセット。
ntp_gettime() はntptimeval 構造体を返します。この構造体の time、maxerror、esterror フィールドに値が入っています。
ntp_gettimex() は ntp_gettime()と同じタスクを実行しますが、 tai フィールドの情報も返します。
返り値
ntp_gettime() と ntp_gettimex() の戻り値は adjtimex(2) と同じです。正しいポインタ引数が与えられれば、これらの関数は常に成功します。
属性
この節で使用されている用語の説明については、 attributes(7) を参照してください。
| インターフェース |
属性 |
値
|
| ntp_gettime(), ntp_gettimex() |
Thread safety |
MT-Safe
|
標準
- ntp_gettime()
- NTP カーネル アプリケーション プログラム インタフェース。
- ntp_gettimex()
- GNU.
履歴
- ntp_gettime()
- glibc 2.1.
- ntp_gettimex()
- glibc 2.12.
関連項目
adjtimex(2), ntp_adjtime(3), time(7)
NTP "Kernel Application Program Interface"
関連キーワード
Linux マニュアル 一覧
関連するコマンド・関数
Index
- 名前
- ライブラリ
- 書式
- 説明
- 返り値
- 属性
- 標準
- 履歴
- 関連項目
This document was created by man2html, using the manual pages.
Time: 04:39:08 GMT, October 11, 2026