Commit | Line | Data |
---|---|---|
2c96395c | 1 | .\" Copyright (c) 1980, 1991 Regents of the University of California. |
94bed826 | 2 | .\" All rights reserved. |
c5780706 | 3 | .\" |
2c96395c | 4 | .\" %sccs.include.redist.roff% |
94bed826 | 5 | .\" |
2c96395c | 6 | .\" @(#)time.1 6.4 (Berkeley) %G% |
c5780706 | 7 | .\" |
2c96395c CL |
8 | .Dd |
9 | .Dt TIME 1 | |
10 | .Os BSD 4 | |
11 | .Sh NAME | |
12 | .Nm time | |
13 | .Nd time command execution | |
14 | .Sh SYNOPSIS | |
15 | .Nm time | |
16 | .Op Fl l | |
17 | .Ar command | |
18 | .Sh DESCRIPTION | |
19 | The | |
20 | .Nm time | |
21 | utility | |
22 | executes and | |
23 | times | |
24 | .Ar command | |
25 | by initiating a timer and passing the | |
26 | .Ar command | |
27 | to the | |
28 | shell. | |
29 | After the | |
30 | .Ar command | |
31 | finishes, | |
32 | .Nm time | |
33 | writes to the standard error stream, | |
34 | (in seconds): | |
35 | the total time elapsed, | |
36 | time consumed by system overhead, | |
37 | and the time used to execute the | |
38 | .Ar command | |
39 | process. | |
40 | .Pp | |
41 | Available options: | |
42 | .Bl -tag -width Ds | |
43 | .It Fl l | |
44 | The contents of the | |
45 | .Em rusage | |
46 | structure are printed as well. | |
47 | .El | |
48 | .Pp | |
49 | The | |
50 | .Xr csh 1 | |
51 | has its own and syntactically different builtin version of | |
52 | .Nm time. | |
53 | The command described here | |
54 | is available as | |
55 | .Pa /bin/time | |
56 | to | |
57 | .Xr csh | |
58 | users. | |
59 | .Sh BUGS | |
60 | The granularity of seconds on micro processors is crude and | |
61 | can result in times being reported for CPU usage which are too large by | |
62 | a second. | |
63 | .Sh SEE ALSO | |
64 | .Xr csh 1 | |
65 | .Sh FILES | |
66 | .Bl -tag -width /usr/include/sys/h/resource.h -compact | |
67 | .It Pa /usr/include/sys/h/resource.h | |
68 | .El | |
69 | .Sh HISTORY | |
70 | A | |
71 | .Nm | |
72 | command appeared in | |
73 | .At v6 . |