[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.1 (Berkeley) %G%
.\"
.TH TIME 1 ""
.UC 4
.SH NAME
time \- time a command
.SH SYNOPSIS
.B time
command
.SH DESCRIPTION
The
given command is executed; after it is complete,
.I time
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.
.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.
.PP
.I Time
is built in to
.IR csh (1),
using a different output format.
.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.
.PP
.I Time
is a built-in command to
.IR csh (1),
with a much different syntax.  This command is available as
``/bin/time'' to
.I csh
users.
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	.\"
e5e18cb6	5	.\" @(#)time.1 6.1 (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
	13	command
	14	.SH DESCRIPTION
	15	The
	16	given command is executed; after it is complete,
	17	.I time
	18	prints the elapsed time during the command, the time
	19	spent in the system, and the time spent in execution
	20	of the command.
	21	Times are reported in seconds.
	22	.PP
	23	On a PDP-11, the execution time can depend on what kind of memory
	24	the program happens to land in;
	25	the user time in MOS is often half what it is in core.
	26	.PP
	27	The times are printed on the diagnostic output stream.
	28	.PP
	29	.I Time
	30	is built in to
056c4bca	31	.IR csh (1),
c5780706 KM	32	using a different output format.
	33	.SH BUGS
	34	Elapsed time is accurate to the second,
	35	while the CPU times are measured
056c4bca	36	to the 100th second.
c5780706 KM	37	Thus the sum of the CPU times can be up to a second larger
	38	than the elapsed time.
	39	.PP
	40	.I Time
	41	is a built-in command to
	42	.IR csh (1),
	43	with a much different syntax. This command is available as
	44	``/bin/time'' to
	45	.I csh
	46	users.