CLOCK_GETRES

名前

書式

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);

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

clock_getres(), clock_gettime(), clock_settime(): _POSIX_C_SOURCE >= 199309L  

説明

関数 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

システム全体のリアルタイムクロック。 このクロックを設定するには適切な特権が必要である。

CLOCK_MONOTONIC

いくつかの開始点が指定されていないため、 クロックがモノトニックタイムを設定したり表現したりできない。

CLOCK_PROCESS_CPUTIME_ID

CPU による高分解能のプロセス毎のタイマ。

CLOCK_THREAD_CPUTIME_ID

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

返り値

エラー

EFAULT

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

EINVAL

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

EPERM

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

準拠

可用性

注意

SMP システムについての注意

SMP システムの各 CPU が別々のクロック源を持つ場合、 タイマレジスタ間の相互関係を管理する方法はない。 これは各 CPU が微妙に異なる周波数で動作するためである。 これが真実の場合 (訳註: 各 CPU が別々のクロック源を持つ場合)、 clock_getcpuclockid(0) は ENOENT を返して、その状況を表す。 2 つのクロックは、プロセスが特定の CPU 上に留まっていることが 保証できる場合にのみ有効である。

SMP システムの各プロセッサは全く同じ時刻に起動する訳ではないので、 各タイマレジスタは通常はあるオフセットで動作している。 オフセットをブート時に制限するコードが含まれるアーキテクチャもある。 しかし、このコードがオフセットを正確に調整することは保証できない。 glibc は (Linux カーネルとは異なり) オフセットを扱うためのコードを提供しない。 通常はこれらのオフセットが小さいので、多くの場合でその影響は無視できる。  

関連項目

Index

名前

書式

説明

返り値

エラー

準拠

可用性

注意

SMP システムについての注意

関連項目