Manpages

名 前

clock_getres, clock_gettime, clock_settime − ク ロ ッ ク と 時 間 の 関 数

書 式

#include <time.h>

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():

_POSIX_C_SOURCE >= 199309L

説 明

関 数 clock_getres() は 指 定 さ れ た ク ロ ッ ク clk_id の 分 解 能 (精 度 ) を 探 し 出 す 。 res が NULL で な い 場 合 、 そ の 分 解 能 を res で 指 さ れ る struct timespec に 格 納 す る 。 ク ロ ッ ク の 分 解 能 は 実 装 に 依 存 し 、 特 定 の プ ロ セ ス に よ っ て 設 定 す る こ と は で き な い 。 clock_settime() の 引 き 数 tp で 指 さ れ る 時 間 の 値 が res の 倍 数 で な い 場 合 、 res の 倍 数 に 切 り 詰 め ら れ る 。 関 数 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 タ イ ム ク ロ ッ ク 。

返 り 値

clock_gettime(), clock_settime(), clock_getres() は 成 功 し た 場 合 に 0 を 返 し 、 失 敗 し た 場 合 に −1 を 返 す (失 敗 し た 場 合 、 errno が 適 切 に 設 定 さ れ る )。

エ ラ ー