Linux用户手册 第1部分
更新日期： 2019-03-06

名称

time-为简单命令计时或提供资源使用情况

语法

时间[选项]命令[参数...]

说明

time命令使用给定参数运行指定的程序命令。命令完成后，时间将消息写入标准错误，提供有关此程序运行的计时统计信息。这些统计信息包括(i)调用和终止之间经过的实时时间，(ii)用户CPU时间(由times(2)返回的结构tms中tms_utime和tms_cutime值的总和)，以及(iii)系统CPU时间(由times(2)返回的结构tms中tms_stime和tms_cstime值的总和)。

注意：某些shell(例如bash(1))具有内置的time命令，该命令提供有关时间使用情况以及可能的其他资源的类似信息。要访问实际命令，您可能需要指定其路径名(类似于/ usr / bin / time)。

选项

-p

在POSIX语言环境中，请使用精确的传统格式

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

(以秒为单位的数字)，其中未指定％f的输出中的小数位数，但足以表示时钟滴答精度，并且至少为1。

退出状态

如果命令被调用，则退出状态为命令的退出状态。否则，如果找不到命令，则为127；如果找到但无法调用，则为126；如果其他地方出错，则为其他非零值(1-125)。

环境

变量LANG，LC_ALL，LC_CTYPE，LC_MESSAGES，LC_NUMERIC和NLSPATH用于输出的文本和格式。 PATH用于搜索命令。其余的用于文本和输出格式。

GNU VERSION

下面描述了GNU 1.7版本的时间。不管实用程序的名称如何，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

The format string

该格式以通常的类似于printf的方式解释。直接复制普通字符，使用\ t，\ n和\转义制表符，换行符和反斜杠，百分号用%%表示，否则％表示转换。程序时间将始终添加尾随换行符。转换如下。支持tcsh(1)使用的所有那些。

时间

%E

经过的实时时间(以[小时：]分钟：秒为单位)。

%e

(不在tcsh(1)中。)实时耗用的时间(以秒为单位)。

%S

进程在内核模式下花费的CPU秒总数。

%U

进程在用户模式下花费的CPU秒总数。

%P

此作业获得的CPU百分比，计算为(％U +％S)/％E。

记忆

%M

进程在其生存期内的最大常驻集大小，以KB为单位。

%t

(不在tcsh(1)中。)进程的平均居民集大小，以KB为单位。

%K

进程的平均总(数据+堆栈+文本)内存使用量，以KB为单位。

%D

进程的非共享数据区域的平均大小，以KB为单位。

%p

(不在tcsh(1)中。)进程的未共享堆栈空间的平均大小，以KB为单位。

%X

进程共享文本空间的平均大小，以KB为单位。

%Z

(不在tcsh(1)中。)系统的页面大小，以字节为单位。这是每个系统的常数，但在系统之间有所不同。

%F

进程运行时发生的主要页面错误数。这些是必须从磁盘读取页面的故障。

%R

轻微或可恢复的页面错误数。这些是无效页面的错误，但尚未被其他虚拟页面声明。因此，页面中的数据仍然有效，但是必须更新系统表。

%W

进程从主内存中换出的次数。

%c

进程非自愿进行上下文切换的次数(因为时间片已过期)。

%w

等待次数：程序自愿进行上下文切换的次数，例如，在等待I / O操作完成时。

输入输出

%I

进程中文件系统输入的数量。

%O

进程中文件系统输出的数量。

%r

进程收到的套接字消息数。

%s

进程发送的套接字消息数。

%k

传递到过程的信号数。

%C

(tcsh(1)中没有。)定时命令的名称和命令行参数。

%x

(不在tcsh(1)中。)命令的退出状态。

GNU options

-f format, --format=format

指定输出格式，可能会覆盖环境变量TIME中指定的格式。

-p, --portability

使用可移植的输出格式。

-o file, --output=file

不要将结果发送到stderr，但是会覆盖指定的文件。

-a, --append

(与-o一起使用。)不要覆盖而是追加。

-v, --verbose

提供有关所有程序了解的非常详细的输出。

-q, --quiet

不要报告程序异常终止(命令被信号终止)或非零退出状态。

GNU standard options

--help

在标准输出上打印使用情况消息并成功退出。

-V, --version

在标准输出上打印版本信息，然后成功退出。

--

终止选项列表。

BUGS

并非所有版本的UNIX都测量所有资源，因此某些值可能会报告为零。当前的选择主要是受4.2或4.3BSD提供的数据的启发。

GNU时间1.7版尚未本地化。因此，它没有实现POSIX要求。

错误选择了环境变量TIME。对于像autoconf(1)或make(1)这样的系统，使用带有实用程序名称的环境变量来覆盖要使用的实用程序并不罕见。诸如MORE或TIME这样的程序选项(而不是程序路径名)的使用往往会导致困难。

不幸的是，-o覆盖而不是附加。 (也就是说，-a选项应该是默认选项。)

time --version

以及您使用的操作系统和C编译器。

另外参见

bash(1)，tcsh(1)，times(2)，wait3(2)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。