名 前
time − コ マ ン ド の 時 間 計 測 や リ ソ ー ス 使 用 量 を 表 示 す る
書 式
time [options] command [arguments...]
説 明
time コ マ ン ド は 、 指 定 さ れ た プ ロ グ ラ ム command を 渡 さ れ た 引 き 数 で 実 行 す る 。 command が 終 了 す る と 、 time は こ の プ ロ グ ラ ム の 実 行 時 間 の 統 計 情 報 に つ い て の メ ッ セ ー ジ を 標 準 エ ラ ー 出 力 に 出 力 す る 。 表 示 さ れ る 統 計 情 報 は 以 下 の 三 つ か ら 構 成 さ れ る : (i) 起 動 か ら 終 了 ま で に 経 過 し た 実 時 間 (real time)、 (ii) ユ ー ザ ー CPU 時 間 (times(2) が 返 す struct tms の tms_utime と tms_cutime の 値 の 合 計 )、 (iii) シ ス テ ム CPU 時 間 (times(2) が 返 す struct tms の tms_stime と tms_cstime の 値 の 合 計 )。
(bash(1) な ど の ) い く つ か の シ ェ ル に は 、 こ こ で 説 明 す る コ マ ン ド よ り も 機 能 が 少 な い 、 組 み 込 み の time コ マ ン ド が 存 在 す る 。 組 み 込 み で は な い 実 際 の コ マ ン ド を 使 用 す る た め に は 、 (/usr/bin/time の よ う な ) コ マ ン ド の パ ス 名 を 指 定 す る 必 要 が あ る か も し れ な い 。
オ プ シ ョ ン
−p
POSIX ロ ケ ー ル の 場 合 、 伝 統 的 な フ ォ ー マ ッ ト で あ る
"real %f\nuser %f\nsys %f\n" が 使 用 さ れ る (各 数 字 は 秒 単 位 )。 %f の 出 力 で の 小 数 点 以 下 の 桁 数 は 規 定 さ れ て い な い が 、 ク ロ ッ ク テ ィ ッ ク (clock tick) の 精 度 を 表 す の に 十 分 な 桁 数 と な り 、 少 な く と も 一 桁 は 存 在 す る 。
終 了 ス テ ー タ ス
command が 起 動 さ れ た 場 合 は 、 command の 終 了 ス テ ー タ ス が 終 了 ス テ ー タ ス と な る 。 command が 見 つ か ら な か っ た 場 合 は 終 了 ス テ ー タ ス は 127 で 、 command が 見 つ か っ た が 起 動 で き な か っ た 場 合 は 126 と な る 。 こ れ 以 外 で 何 か エ ラ ー が あ っ た 場 合 は 、 終 了 ス テ ー タ ス は 0 以 外 の 前 記 以 外 の 値 (1−125) の 何 か に な る 。
環 境 変 数
環 境 変 数 LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC, NLSPATH, PATH が 使 用 さ れ る 。 PATH は command を 探 す の に 使 わ れ る 。 そ れ 以 外 は 出 力 文 字 や 書 式 に 使 用 さ れ る 。
GNU バ ー ジ ョ ン
以 下 は GNU 1.7 バ ー ジ ョ ン の time の 説 明 で あ る 。 コ マ ン ド 名 と は 裏 腹 に 、 GNU バ ー ジ ョ ン で は 有 益 な 情 報 が た く さ ん 出 力 さ れ る 。 使 用 時 間 だ け で な く 、 (取 得 で き る 場 合 に は ) メ モ リ ー や I/O、 IPC 呼 び 出 し な ど の 他 の リ ソ ー ス に 関 す る 情 報 も 出 力 さ れ る 。 出 力 は フ ォ ー マ ッ ト 文 字 列 を 使 っ て 整 形 さ れ 、 フ ォ ー マ ッ ト 文 字 列 は −f オ プ シ ョ ン か 環 境 変 数 TIME で 指 定 で き る 。 デ フ ォ ル ト の フ ォ ー マ ッ ト 文 字 列 は 以 下 の 通 り 。
%Uuser %Ssystem
%Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
−p オ プ シ ョ ン が 指 定 さ れ た 場 合 に は 、
real %e
user %U
sys %S と い う (他 と
互 換 性 の あ る )
出 力 フ ォ ー マ
ッ ト が 使 用 さ
れ る 。 フ ォ ー
マ ッ ト 文 字 列
フ ォ ー マ ッ ト
は よ く あ る printf 形
式 で 解 釈 さ れ
る 。 通 常 の 文
字 は そ の ま ま
コ ピ ー さ れ 、
タ ブ 、 改 行
(newline)、 バ ッ ク ス
ラ ッ シ ュ は そ
れ ぞ れ \t, \n, \\ で エ
ス ケ ー プ さ れ
る 。 パ ー セ ン
ト 記 号 は %% で 表
現 さ れ 、 そ れ
以 外 の % は 変 換
を 示 す 。 末 尾
に は 必 ず 改 行
文 字 (newline) が 追 加
さ れ る 。 変 換
は 以 下 の 通 り
で あ る 。 tcsh(1) で
使 用 さ れ る 変
換 は 全 て サ ポ
ー ト さ れ て い
る 。
Time
%E 経 過 し た 実 時 間
([hours:]minutes:seconds の 形 式 )。
%e
(tcsh に は な い ) 経 過 し た 実 時 間 (秒 単 位 )。
%S そ の プ ロ セ ス が カ ー ネ ル モ ー ド で 消 費 し た
CPU 時 間 の 合 計 (秒 単 位 )。
%U そ の プ ロ セ ス が ユ ー ザ ー モ ー ド で 消 費 し た
CPU 時 間 の 合 計 (秒 単 位 )。
%P こ の ジ ョ ブ が 獲 得 し た
CPU の 割 り 合 い (パ ー セ ン テ ー ジ )。 (%U + %S) / %E で 計 算 さ れ る 。
Memory
%M プ ロ セ ス 生 存 中 の そ の プ ロ セ ス の
resident set size の 最 大 値 。 キ ロ
バ イ ト 単 位 。
%t
(tcsh に は な い ) そ の プ ロ セ ス の resident set size の 平 均 値 。 キ ロ バ イ ト 単 位 。
%K
そ の プ
ロ セ ス の メ モ
リ ー 使 用 量 の
合 計 (デ ー タ +ス
タ ッ ク +テ キ ス
ト ) の 平 均 値 。
キ ロ バ イ ト 単
位 。
%D
そ の プ ロ セ ス の 非 共 有 デ ー タ 領 域 の 平 均 サ イ ズ 。 キ ロ バ イ ト 単 位 。
%p
(tcsh に は な い ) そ の プ ロ セ ス の 非 共 有 ス タ ッ ク 空 間 の 平 均 サ イ ズ 。 キ ロ バ イ ト 単 位 。
%X
そ の プ ロ セ ス の 共 有 テ キ ス ト 空 間 の 平 均 サ イ ズ 。 キ ロ バ イ ト 単 位 。
%Z
(tcsh に は な い ) シ ス テ ム の ペ ー ジ サ イ ズ (バ イ ト 単 位 )。 こ の 値 は シ ス テ ム 毎 に 決 ま る 定 数 だ が 、 シ ス テ ム に よ り 異 な る 。
%F
プ ロ セ ス の 動 作 中 に 発 生 し た メ ジ ャ ー ペ ー ジ フ ォ ル ト の 回 数 。 こ れ は 、 デ ィ ス ク か ら ペ ー ジ を 読 み 込 む 必 要 が あ っ た ペ ー ジ フ ォ ル ト に 関 す る も の で あ る 。
%R マ イ ナ ー ペ ー ジ フ ォ ー ル ト 、 つ ま り 回 復 可 能 な ペ ー ジ フ ォ ル ト の 回 数 。 こ れ は 、 そ の ペ ー ジ は 有 効 で な い が 、 ま だ 他 の 仮 想 ペ ー ジ に 奪 わ れ て い な か っ た ペ ー ジ に 対 す る ペ ー ジ フ ォ ル ト に 関 す る も の で あ る 。
%W そ の プ ロ セ ス が 主 記 憶 か ら ス ワ ッ プ ア ウ ト さ れ た 回 数 。
%c そ の プ ロ セ ス が
(タ イ ム ス ラ イ ス の 経 過 に よ り ) 強 制 的 に コ ン テ キ ス ト ス イ ッ チ さ れ た 回 数 。
%w
wait の 回 数 、 つ ま り そ の プ ロ グ ラ ム が 自 発 的 に コ ン テ キ ス ト ス イ ッ チ さ れ た 回 数 。 例 え ば 、 I/O 操 作 の 完 了 を 待 っ て い る 間 な ど が 該 当 す る 。
I/O
%I そ の プ ロ セ ス に よ る フ ァ イ ル シ ス テ ム か ら の 入 力 の 回 数 。
%O そ の プ ロ セ ス に よ る フ ァ イ ル シ ス テ ム へ の 出 力 の 回 数 。
%r そ の プ ロ セ ス が 受 信 し た ソ ケ ッ ト メ ッ セ ー ジ 数 。
%s そ の プ ロ セ ス が 送 信 し た ソ ケ ッ ト メ ッ セ ー ジ 数 。
%k そ の プ ロ セ ス に 配 送 さ れ た シ グ ナ ル 数 。
%C
(tcsh に は な い ) time の 対 象 と な っ た コ マ ン ド 名 と コ マ ン ド ラ イ ン 引 き 数 。
%x
(tcsh に は な い ) コ マ ン ド の 終 了 ス テ ー タ ス 。
GNU オ
プ シ ョ ン
−f FORMAT,
−−format=FORMAT 出 力
フ ォ ー マ ッ ト
を 指 定 す る 。
環 境 変 数 TIME で
指 定 さ れ た フ
ォ ー マ ッ ト よ
り も 優 先 さ れ
る 。
−p, −−portability 他 の
time と 互 換 性 の あ
る 出 力 フ ォ ー
マ ッ ト を 使 用
す る 。
−o FILE,
−−output=FILE 結 果
を stderr に 送 ら ず
、 指 定 さ れ た
フ ァ イ ル に 書
き 込 む 。 フ ァ
イ ル は 上 書 き
さ れ る 。
−a, −−append
(−o と 一 緒 に 使 用 す る 。 ) フ ァ イ ル を 上 書 き せ ず に 、 結 果 を フ ァ イ ル 末 尾 に 追 加 す る 。
−v, −−verbose 非 常 に 詳 し い 出 力 で 、 入 手 で き る 全 て の 情 報 を 出 力 す る 。
GNU 標 準 オ プ シ ョ ン
−−help 使 用 方 法 に 関 す る メ ッ セ ー ジ を 標 準 出 力 に 表 示 し 、 正 常 終 了 す る 。
−V, −−version バ ー ジ ョ ン 情 報 を 標 準 出 力 に 表 示 し 、 正 常 終 了 す る 。
−− オ プ シ ョ ン リ ス ト の 末 尾 を 示 す 。
バ グ
全 て の リ ソ ー ス が UNIX の 全 て の バ ー ジ ョ ン で 計 測 さ れ て い る わ け で は な い の で 、 い く つ か の 値 が 0 と 報 告 さ れ る 可 能 性 が あ る 。 現 在 の 出 力 項 目 の ほ と ん ど は 4.2BSD や 4.3BSD で 取 得 可 能 な デ ー タ に 基 づ い て 選 択 さ れ て い る 。
GNU time バ ー ジ ョ ン 1.7 は ま だ ロ ー カ ラ イ ズ さ れ て い な い 。 そ の た め 、 POSIX の 要 件 を 実 装 し て い な い こ と に な る 。
TIME と い う 環 境 変 数 は 名 前 の 選 択 が ま ず い 。 autoconf(1) や make(1) の よ う な シ ス テ ム で は 、 使 用 す る コ マ ン ド を 上 書 き す る の に そ の コ マ ン ド の 名 前 の 環 境 変 数 を 使 う の が 珍 し く な い 。 MORE や TIME の よ う な 名 前 を (プ ロ グ ラ ム の パ ス 名 の 指 定 で は な く ) プ ロ グ ラ ム へ の オ プ シ ョ ン を 指 定 す る の に 使 う と 、 面 倒 な こ と を 引 き 起 こ す 可 能 性 が 高 い 。
−o が 追 記 で は な く 上 書 き に な っ て い る の は 残 念 な こ と だ (つ ま り −a オ プ シ ョ ン が デ フ ォ ル ト に な っ て い る べ き だ ろ う と い う こ と だ )。
GNU time
に 対 す る 提 案
や バ グ レ ポ ー
ト は
bug−utils [AT] prep.edu ま で
メ ー ル を 送 っ
て ほ し い 。 そ
の 場 合 に は time
や OS、 使 用 し て
い る C コ ン パ イ
ラ の バ ー ジ ョ
ン を 記 載 し て
ほ し い 。 time の
バ ー ジ ョ ン は
time −−version で 取 得
で き る 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。