TIME

名前

書式

説明

Note: some shells (e.g., bash(1)) have a built-in time command that provides similar information on the usage of time and possibly other resources. To access the real command, you may need to specify its pathname (something like /usr/bin/time).  

オプション

-p

POSIX ロケールの場合、伝統的なフォーマットである

 "real %f\nuser %f\nsys %f\n"

が使用される (各数字は秒単位)。 %f の出力での小数点以下の桁数は規定されていないが、 クロックティック (clock tick) の精度を表すのに十分な桁数となり、 少なくとも一桁は存在する。

終了ステータス

環境変数

GNU バージョン

デフォルトのフォーマット文字列は以下の通り。

 %Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k %Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

-p オプションが指定された場合には、(他と互換性のある) 出力フォーマットが使用される:

 real %e user %U sys %S  

フォーマット文字列

Time

%E

経過した実時間 ([hours:]minutes:seconds の形式)。

%e

(tcsh(1) にはない) 経過した実時間 (秒単位)。

%S

そのプロセスがカーネルモードで消費した CPU 時間の合計 (秒単位)。

%U

そのプロセスがユーザーモードで消費した CPU 時間の合計 (秒単位)。

%P

このジョブが獲得した CPU の割り合い (パーセンテージ)。 (%U + %S) / %E で計算される。

Memory

%M

プロセス生存中のそのプロセスの resident set size の最大値。 キロバイト単位。

%t

(tcsh(1) にはない) そのプロセスの resident set size の平均値。 キロバイト単位。

%K

そのプロセスのメモリー使用量の合計 (データ+スタック+テキスト) の平均値。 キロバイト単位。

%D

そのプロセスの非共有データ領域の平均サイズ。 キロバイト単位。

%p

(tcsh(1) にはない) そのプロセスの非共有スタック空間の平均サイズ。 キロバイト単位。

%X

そのプロセスの共有テキスト空間の平均サイズ。 キロバイト単位。

%Z

(tcsh(1) にはない) システムのページサイズ (バイト単位)。 この値はシステム毎に決まる定数だが、システムにより異なる。

%F

プロセスの動作中に発生したメジャーページフォルトの回数。 これは、ディスクからページを読み込む必要があったページフォルトに 関するものである。

%R

マイナーページフォールト、つまり回復可能なページフォルトの回数。 これは、そのページは有効でないが、まだ他の仮想ページに奪われて いなかったページに対するページフォルトに関するものである。

%W

そのプロセスが主記憶からスワップアウトされた回数。

%c

そのプロセスが (タイムスライスの経過により) 強制的にコンテキストスイッチ された回数。

%w

wait の回数、つまりそのプログラムが自発的にコンテキストスイッチされた回数。 例えば、I/O 操作の完了を待っている間などが該当する。

I/O

%I

そのプロセスによるファイルシステムからの入力の回数。

%O

そのプロセスによるファイルシステムへの出力の回数。

%r

そのプロセスが受信したソケットメッセージ数。

%s

そのプロセスが送信したソケットメッセージ数。

%k

そのプロセスに配送されたシグナル数。

%C

(tcsh(1) にはない) time の対象となったコマンド名とコマンドライン引数。

%x

(tcsh(1) にはない) コマンドの終了ステータス。

GNU オプション

 -f format, --format=format

出力フォーマットを指定する。 環境変数 TIME で指定されたフォーマットよりも優先される。

-p, --portability

他の time と互換性のある出力フォーマットを使用する。

 -o file, --output=file

結果を stderr に送らず、指定されたファイルに書き込む。 ファイルは上書きされる。

-a, --append

(-o と一緒に使用する。) ファイルを上書きせずに、結果をファイル末尾に追加する。

-v, --verbose

非常に詳しい出力で、入手できる全ての情報を出力する。

 -q, --quiet

Don't report abnormal program termination (where command is terminated by a signal) or nonzero exit status.

GNU 標準オプション

--help

使用方法に関するメッセージを標準出力に表示し、正常終了する。

-V, --version

バージョン情報を標準出力に表示し、正常終了する。

--

オプションリストの末尾を示す。

バグ

GNU time バージョン 1.7 はまだローカライズされていない。 そのため、POSIX の要件を実装していないことになる。

TIME という環境変数は名前の選択がまずい。 autoconf(1) や make(1) のようなシステムでは、使用するコマンドを上書きするのにそのコマンドの 名前の環境変数を使うのが珍しくない。 MORE や TIME のような名前を (プログラムのパス名の指定ではなく) プログラムへのオプションを指定するのに使うと、 面倒なことを引き起こす可能性が高い。

-o が追記ではなく上書きになっているのは残念なことだ (つまり -a オプションがデフォルトになっているべきだろうということだ)。

Mail suggestions and bug reports for GNU time to bug-time@gnu.org. Please include the version of time, which you can get by running

 time --version

で取得できる。  

関連項目

この文書について

Index

名前

書式

説明

オプション

終了ステータス

環境変数

GNU バージョン

フォーマット文字列

GNU オプション

GNU 標準オプション

バグ

関連項目

この文書について