[unix-history] / usr / src / usr.bin / time / time.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)time.1	6.2 (Berkeley) %G%
.\"
.TH TIME 1 ""
.UC 4
.SH NAME
time \- time a command
.SH SYNOPSIS
.B time
[-l] command
.SH DESCRIPTION
The given command is executed; after it is complete, \fItime\fP
prints the elapsed time during the command, the time spent in the
system, and the time spent in execution of the command.  Times are
reported in seconds.  If the \fB-l\fP option is supplied, the
contents of the \fIrusage\fP structure are printed as well.
.PP
On a PDP-11, the execution time can depend on what kind of memory
the program happens to land in; the user time in MOS is often half
what it is in core.
.PP
The times are printed on the diagnostic output stream, ``stderr''.
.PP
\fITime\fP is a built-in command to \fIcsh\fP(1), with a much different
syntax.  This command is available as ``/bin/time'' to \fIcsh\fP users.
.SH BUGS
Elapsed time is accurate to the second, while the CPU times are measured
to the 100th second.  Thus the sum of the CPU times can be up to a second
larger than the elapsed time.
.SH "SEE ALSO"
include/sys/h/resource.h
Commit	Line	Data
c5780706 KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
e0844c13	5	.\" @(#)time.1 6.2 (Berkeley) %G%
c5780706	6	.\"
e5e18cb6	7	.TH TIME 1 ""
c5780706 KM	8	.UC 4
	9	.SH NAME
	10	time \- time a command
	11	.SH SYNOPSIS
	12	.B time
e0844c13	13	[-l] command
c5780706	14	.SH DESCRIPTION
e0844c13 KB	15	The given command is executed; after it is complete, \fItime\fP
	16	prints the elapsed time during the command, the time spent in the
	17	system, and the time spent in execution of the command. Times are
	18	reported in seconds. If the \fB-l\fP option is supplied, the
	19	contents of the \fIrusage\fP structure are printed as well.
c5780706 KM	20	.PP
c5780706 KM	21	On a PDP-11, the execution time can depend on what kind of memory
e0844c13 KB	22	the program happens to land in; the user time in MOS is often half
e0844c13 KB	23	what it is in core.
c5780706	24	.PP
e0844c13	25	The times are printed on the diagnostic output stream, ``stderr''.
c5780706	26	.PP
e0844c13 KB	27	\fITime\fP is a built-in command to \fIcsh\fP(1), with a much different
e0844c13 KB	28	syntax. This command is available as ``/bin/time'' to \fIcsh\fP users.
c5780706	29	.SH BUGS
e0844c13 KB	30	Elapsed time is accurate to the second, while the CPU times are measured
	31	to the 100th second. Thus the sum of the CPU times can be up to a second
	32	larger than the elapsed time.
	33	.SH "SEE ALSO"
	34	include/sys/h/resource.h