1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)time.1 8.1 (Berkeley) 6/6/93
| 1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)time.1 8.1 (Berkeley) 6/6/93
|
33.\" $FreeBSD: head/usr.bin/time/time.1 50477 1999-08-28 01:08:13Z peter $
| 33.\" $FreeBSD: head/usr.bin/time/time.1 51090 1999-09-08 15:40:46Z sheldonh $
|
34.\"
35.Dd June 6, 1993
36.Dt TIME 1
37.Os BSD 4
38.Sh NAME
39.Nm time
40.Nd time command execution
41.Sh SYNOPSIS
42.Nm
43.Op Fl alp
44.Op Fl o Ar file
45.Ar command
46.Sh DESCRIPTION
47The
48.Nm
49utility
50executes and
51times
52.Ar command
53by initiating a timer and passing the
54.Ar command
55to the
56shell.
57After the
58.Ar command
59finishes,
60.Nm
61writes to the standard error stream,
62(in seconds):
63the total time elapsed,
64the time used to execute the
65.Ar command
66process and the time consumed by system overhead.
67.Pp
68Available options:
69.Bl -tag -width Ds
70.It Fl a
71If the
72.Fl o
73flag is used, append to the specified file rather than overwriting
74it. Otherwise, this option has no effect.
75.It Fl l
76The contents of the
77.Em rusage
78structure are printed as well.
79.It Fl o Ar file
80Write the output to
81.Ar file
82instead of stderr. If
83.Ar file
84exists and the
85.Fl a
86flag is not specified, the file will be overwritten.
87.It Fl p
88Makes
89.Nm
90output POSIX.2 compliant (each time is printed on its own line).
91.El
92.Pp
| 34.\"
35.Dd June 6, 1993
36.Dt TIME 1
37.Os BSD 4
38.Sh NAME
39.Nm time
40.Nd time command execution
41.Sh SYNOPSIS
42.Nm
43.Op Fl alp
44.Op Fl o Ar file
45.Ar command
46.Sh DESCRIPTION
47The
48.Nm
49utility
50executes and
51times
52.Ar command
53by initiating a timer and passing the
54.Ar command
55to the
56shell.
57After the
58.Ar command
59finishes,
60.Nm
61writes to the standard error stream,
62(in seconds):
63the total time elapsed,
64the time used to execute the
65.Ar command
66process and the time consumed by system overhead.
67.Pp
68Available options:
69.Bl -tag -width Ds
70.It Fl a
71If the
72.Fl o
73flag is used, append to the specified file rather than overwriting
74it. Otherwise, this option has no effect.
75.It Fl l
76The contents of the
77.Em rusage
78structure are printed as well.
79.It Fl o Ar file
80Write the output to
81.Ar file
82instead of stderr. If
83.Ar file
84exists and the
85.Fl a
86flag is not specified, the file will be overwritten.
87.It Fl p
88Makes
89.Nm
90output POSIX.2 compliant (each time is printed on its own line).
91.El
92.Pp
|
93Most shells (including
94.Xr csh 1 )
95have their own and syntactically different builtin version of
96.Nm time .
97The command described here
98is available as
99.Pa /usr/bin/time
100to users of those shells.
| 93Some shells may provide a builtin
94.Nm
95command which is similar or identical to this utility. Consult
96the
97.Xr builtin 1
98manual page.
|
101.Sh DIAGNOSTICS
102If
103.Ar command
104could be timed successfully, its exit status is returned. In case
105.Ar command
106terminated abnormally, a warning message is output to stderr.
107If the
108.Ar command
109was found but could not be run, the exit status is 126.
110If no
111.Ar command
112could be found at all, the exit status is 127.
113If
114.Nm
115encounters any other error, the exit status is between 1 and 125
116included.
117.Sh SEE ALSO
| 99.Sh DIAGNOSTICS
100If
101.Ar command
102could be timed successfully, its exit status is returned. In case
103.Ar command
104terminated abnormally, a warning message is output to stderr.
105If the
106.Ar command
107was found but could not be run, the exit status is 126.
108If no
109.Ar command
110could be found at all, the exit status is 127.
111If
112.Nm
113encounters any other error, the exit status is between 1 and 125
114included.
115.Sh SEE ALSO
|
| 116.Xr builtin 1 ,
|
118.Xr csh 1 ,
119.Xr getrusage 2 ,
120.Xr wait 2
121.Sh STANDARDS
122The
123.Nm
124utility is expected to conform to ISO/IEC 9945-2:1993 (``POSIX'').
125.Sh HISTORY
126A
127.Nm
128command appeared in
129.At v6 .
| 117.Xr csh 1 ,
118.Xr getrusage 2 ,
119.Xr wait 2
120.Sh STANDARDS
121The
122.Nm
123utility is expected to conform to ISO/IEC 9945-2:1993 (``POSIX'').
124.Sh HISTORY
125A
126.Nm
127command appeared in
128.At v6 .
|