.\" Copyright Andries Brouwer, 2000
.\" Some fragments of text came from the time-1.7 info file.
.\" Inspired by kromJx@crosswinds.net.
.\"
.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2008  Akihiro MOTOKI
.\"         all rights reserved.
.\" Translated 2008-11-20, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.13
.\"
.TH TIME 1 2019\-03\-06 "" "Linux User's Manual"
.SH 名前
time \- コマンドの時間計測やリソース使用量を表示する
.SH 書式
 \fBtime \fP[\fIoptions\fP]\fI command \fP[\fIarguments...\fP]
.SH 説明
\fBtime\fP コマンドは、指定されたプログラム \fIcommand\fP を渡された引数で実行する。 \fIcommand\fP が終了すると、 \fBtime\fP
はこのプログラムの実行時間の統計情報についてのメッセージを 標準エラー出力に出力する。 表示される統計情報は以下の三つから構成される: (i)
起動から終了までに経過した実時間 (real time)、 (ii) ユーザー CPU 時間 (\fBtimes\fP(2)  が返す \fIstruct
tms\fP の \fItms_utime\fP と \fItms_cutime\fP の値の合計)、 (iii) システム CPU 時間 (\fBtimes\fP(2)
が返す \fIstruct tms\fP の \fItms_stime\fP と \fItms_cstime\fP の値の合計)。
.PP
Note: some shells (e.g., \fBbash\fP(1))  have a built\-in \fBtime\fP 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 \fI/usr/bin/time\fP).
.SH オプション
.TP 
\fB\-p\fP
POSIX ロケールの場合、伝統的なフォーマットである
.IP
.in +4n
.EX
 "real %f\enuser %f\ensys %f\en"
.EE
.in
.IP
が使用される (各数字は秒単位)。 %f の出力での小数点以下の桁数は規定されていないが、 クロックティック (clock tick)
の精度を表すのに十分な桁数となり、 少なくとも一桁は存在する。
.SH 終了ステータス
\fIcommand\fP が起動された場合は、 \fIcommand\fP の終了ステータスが終了ステータスとなる。 \fIcommand\fP
が見つからなかった場合は終了ステータスは 127 で、 \fIcommand\fP が見つかったが起動できなかった場合は 126 となる。
これ以外で何かエラーがあった場合は、終了ステータスは 0 以外の前記以外の値 (1\(en125) の何かになる。
.SH 環境変数
The variables \fBLANG\fP, \fBLC_ALL\fP, \fBLC_CTYPE\fP, \fBLC_MESSAGES\fP,
\fBLC_NUMERIC\fP, and \fBNLSPATH\fP are used for the text and formatting of the
output.  \fBPATH\fP is used to search for \fIcommand\fP.  The remaining ones for
the text and formatting of the output.
.SH "GNU バージョン"
以下は GNU 1.7 バージョンの \fBtime\fP の説明である。コマンド名とは裏腹に、GNU バージョンでは
有益な情報がたくさん出力される。使用時間だけでなく、 (取得できる場合には) メモリーや I/O、IPC 呼び出しなどの他のリソース
に関する情報も出力される。 出力はフォーマット文字列を使って整形され、 フォーマット文字列は \-f オプションか環境変数 \fBTIME\fP で指定できる。
.PP
デフォルトのフォーマット文字列は以下の通り。
.PP
.in +4n
.EX
 %Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
.EE
.in
.PP
\-p オプションが指定された場合には、(他と互換性のある) 出力フォーマットが使用される:
.PP
.in +4n
.EX
 real %e
user %U
sys %S
.EE
.in
.\"
.SS フォーマット文字列
フォーマットはよくある printf 形式で解釈される。 通常の文字はそのままコピーされ、 タブ、改行 (newline)、バックスラッシュはそれぞれ
\et, \en, \e\e で エスケープされる。 パーセント記号は %% で表現され、それ以外の % は変換を示す。 末尾には必ず改行文字
(newline) が追加される。 変換は以下の通りである。 \fBtcsh\fP(1)  で使用される変換は全てサポートされている。
.PP
\fBTime\fP
.TP 
\fB%E\fP
経過した実時間 ([hours:]minutes:seconds の形式)。
.TP 
\fB%e\fP
(\fBtcsh\fP(1) にはない) 経過した実時間 (秒単位)。
.TP 
\fB%S\fP
そのプロセスがカーネルモードで消費した CPU 時間の合計 (秒単位)。
.TP 
\fB%U\fP
そのプロセスがユーザーモードで消費した CPU 時間の合計 (秒単位)。
.TP 
\fB%P\fP
このジョブが獲得した CPU の割り合い (パーセンテージ)。 (%U + %S) / %E で計算される。
.PP
\fBMemory\fP
.TP 
\fB%M\fP
プロセス生存中のそのプロセスの resident set size の最大値。 キロバイト単位。
.TP 
\fB%t\fP
(\fBtcsh\fP(1) にはない)  そのプロセスの resident set size の平均値。 キロバイト単位。
.TP 
\fB%K\fP
そのプロセスのメモリー使用量の合計 (データ+スタック+テキスト) の平均値。 キロバイト単位。
.TP 
\fB%D\fP
そのプロセスの非共有データ領域の平均サイズ。 キロバイト単位。
.TP 
\fB%p\fP
(\fBtcsh\fP(1) にはない)  そのプロセスの非共有スタック空間の平均サイズ。 キロバイト単位。
.TP 
\fB%X\fP
そのプロセスの共有テキスト空間の平均サイズ。 キロバイト単位。
.TP 
\fB%Z\fP
(\fBtcsh\fP(1) にはない) システムのページサイズ (バイト単位)。 この値はシステム毎に決まる定数だが、システムにより異なる。
.TP 
\fB%F\fP
プロセスの動作中に発生したメジャーページフォルトの回数。 これは、ディスクからページを読み込む必要があったページフォルトに 関するものである。
.TP 
\fB%R\fP
マイナーページフォールト、つまり回復可能なページフォルトの回数。 これは、そのページは有効でないが、まだ他の仮想ページに奪われて
いなかったページに対するページフォルトに関するものである。
.TP 
\fB%W\fP
そのプロセスが主記憶からスワップアウトされた回数。
.TP 
\fB%c\fP
そのプロセスが (タイムスライスの経過により) 強制的にコンテキストスイッチ された回数。
.TP 
\fB%w\fP
wait の回数、つまりそのプログラムが自発的にコンテキストスイッチされた回数。 例えば、I/O 操作の完了を待っている間などが該当する。
.PP
\fBI/O\fP
.TP 
\fB%I\fP
そのプロセスによるファイルシステムからの入力の回数。
.TP 
\fB%O\fP
そのプロセスによるファイルシステムへの出力の回数。
.TP 
\fB%r\fP
そのプロセスが受信したソケットメッセージ数。
.TP 
\fB%s\fP
そのプロセスが送信したソケットメッセージ数。
.TP 
\fB%k\fP
そのプロセスに配送されたシグナル数。
.TP 
\fB%C\fP
(\fBtcsh\fP(1) にはない) time の対象となったコマンド名とコマンドライン引数。
.TP 
\fB%x\fP
(\fBtcsh\fP(1) にはない) コマンドの終了ステータス。
.SS "GNU オプション"
.TP 
 \fB\-f \fP\fIformat\fP\fB, \-\-format=\fP\fIformat\fP
出力フォーマットを指定する。 環境変数 \fBTIME\fP で指定されたフォーマットよりも優先される。
.TP 
\fB\-p, \-\-portability\fP
他の time と互換性のある出力フォーマットを使用する。
.TP 
 \fB\-o \fP\fIfile\fP\fB, \-\-output=\fP\fIfile\fP
結果を \fIstderr\fP に送らず、指定されたファイルに書き込む。 ファイルは上書きされる。
.TP 
\fB\-a, \-\-append\fP
(\-o と一緒に使用する。)  ファイルを上書きせずに、結果をファイル末尾に追加する。
.TP 
\fB\-v, \-\-verbose\fP
非常に詳しい出力で、入手できる全ての情報を出力する。
.TP 
 \fB\-q, \-\-quiet\fP
.\"
Don't report abnormal program termination (where \fIcommand\fP is terminated by
a signal) or nonzero exit status.
.SS "GNU 標準オプション"
.TP 
\fB\-\-help\fP
使用方法に関するメッセージを標準出力に表示し、正常終了する。
.TP 
\fB\-V, \-\-version\fP
バージョン情報を標準出力に表示し、正常終了する。
.TP 
\fB\-\-\fP
オプションリストの末尾を示す。
.SH バグ
全てのリソースが UNIX の全てのバージョンで計測されているわけではないので、 いくつかの値が 0 と報告される可能性がある。
現在の出力項目のほとんどは 4.2BSD や 4.3BSD で取得可能なデータに 基づいて選択されている。
.PP
GNU time バージョン 1.7 はまだローカライズされていない。 そのため、POSIX の要件を実装していないことになる。
.PP
\fBTIME\fP という環境変数は名前の選択がまずい。 \fBautoconf\fP(1)  や \fBmake\fP(1)
のようなシステムでは、使用するコマンドを上書きするのにそのコマンドの 名前の環境変数を使うのが珍しくない。 MORE や TIME のような名前を
(プログラムのパス名の指定ではなく)  プログラムへのオプションを指定するのに使うと、 面倒なことを引き起こす可能性が高い。
.PP
\-o が追記ではなく上書きになっているのは残念なことだ (つまり \-a オプションがデフォルトになっているべきだろうということだ)。
.PP
Mail suggestions and bug reports for GNU \fBtime\fP to \fIbug\-time@gnu.org\fP.
Please include the version of \fBtime\fP, which you can get by running
.PP
.in +4n
.EX
 time \-\-version
.EE
.in
.PP
.\" .SH AUTHORS
.\" .TP
.\" .IP "David Keppel"
.\" Original version
.\" .IP "David MacKenzie"
.\" POSIXization, autoconfiscation, GNU getoptization,
.\" documentation, other bug fixes and improvements.
.\" .IP "Arne Henrik Juul"
.\" Helped with portability
.\" .IP "Francois Pinard"
.\" Helped with portability
で取得できる。
.SH 関連項目
 \fBbash\fP(1), \fBtcsh\fP(1), \fBtimes\fP(2), \fBwait3\fP(2)
.SH この文書について
この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は
\%https://www.kernel.org/doc/man\-pages/ に書かれている。