名前¶

書式¶

int clock_getres(clockid_t clk_id, struct timespec *res);

int clock_gettime(clockid_t clk_id, struct timespec *tp);

int clock_settime(clockid_t clk_id, const struct timespec *tp);

-lrt とリンクする (バージョン 2.17 より前の glibc のみ)

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

clock_getres(), clock_gettime(), clock_settime():

説明¶

関数 clock_gettime() と clock_settime() は、指定されたクロック clk_id の時間を取得または設定する。

res と tp 引き数は timespec 構造体であり、 <time.h> で以下のように規定されている:

struct timespec {
    time_t   tv_sec;        /* seconds */
    long     tv_nsec;       /* nanoseconds */
};

clk_id 引き数は特定のクロックの識別子であり、そのクロックで動作する。 クロックはシステム全体に適用することもでき、 その場合は全てのプロセスから見ることができる。 また 1 つのプロセス内でのみ時間を計測する場合は、 プロセス毎に適用することもできる。

全ての実装においてシステム全体のリアルタイムクロックがサポートされ、 CLOCK_REALTIME で識別される。 時間は紀元 (the Epoch) からの秒とナノ秒で表される。 時間が変更された場合、相対的な時間間隔のタイマーは影響を受けないが、 絶対的な時点のタイマーは影響を受ける。

さらにいくつかのクロックが実装されているかもしれない。 対応する時間の値を解釈する方法とタイマーへの影響は、定められていない。

glibc と Linux カーネルの最新のバージョンでは、 以下のクロックがサポートされている。

CLOCK_REALTIME

実時間を計測するシステム全体で一意な時間。 このクロックを設定するには適切な特権が必要である。 このクロックは、システム時間の不連続な変化 (例えば、システム管理者が システム時間を手動で変更した場合など) や adjtime や NTP が行う 段階的な調整の影響を受ける。

CLOCK_REALTIME_COARSE (Linux 2.6.32 以降; Linux 特有)

高速だが精度が低い CLOCK_REALTIME。速度が非常に必要で、かつ高精度のタイムスタンプが不要な場合に使用するとよい。

CLOCK_MONOTONIC

設定することができないクロックで、ある開始時点からの単調増加の時間で 表現されるクロック (開始時点がどの時点となるかは規定されていない)。 この時計は、システム時間の不連続な変化 (例えば、システム管理者がシステ ム時間を手動で変更した場合など) の影響を受けないが、 adjtime(3) や NTP が行う段階的な調整の影響を受ける。

CLOCK_MONOTONIC_COARSE (Linux 2.6.32 以降; Linux 特有)

高速だが精度が低い CLOCK_MONOTONIC。速度が非常に必要で、かつ高精度のタイムスタンプが不要な場合に使用するとよい。

CLOCK_MONOTONIC_RAW (Linux 2.6.28 以降; Linux 特有)

CLOCK_MONOTONIC と同様だが、NTP による調整や adjtime(3) が行う 段階的な調整の影響を受けない、ハードウェアによる生の時刻へのアクセス ができる。

CLOCK_BOOTTIME (Linux 2.6.39 以降; Linux 固有)

CLOCK_MONOTONIC と同じだが、システムがサスペンドされている時間も含まれる点が異なる。 これを使うと、アプリケーションはサスペンド状態も扱える "monotonic" なクロックを得ることができる。 しかも、 CLOCK_REALTIME における複雑な処理を行う必要もなくなる。 CLOCK_REALTIME では、 settimeofday(2) を使って時刻を変更した場合、時刻に不連続な変化が発生するからだ。

CLOCK_PROCESS_CPUTIME_ID (Linux 2.6.12 以降)

プロセス単位の CPU タイムクロック (そのプロセスの全スレッドで消費される CPU 時間を計測する)。

CLOCK_THREAD_CPUTIME_ID (Linux 2.6.12 以降)

スレッド固有の CPU タイムクロック。

返り値¶

エラー¶

EFAULT

tp がアクセス可能なアドレス空間の外を指した。

EINVAL

指定された clk_id がこのシステムでサポートされていない。

EPERM

指示されたクロックを設定する権限が clock_settime() にない。

バージョン¶

準拠¶

可用性¶

注意¶

バグ¶

関連項目¶

この文書について¶