usr/src/usr.bin/time/time.1

.\" Copyright (c) 1980, 1991, 1993
.\"     The Regents of the University of California.  All rights reserved.
.\"
.\" %sccs.include.redist.roff%
.\"
.\"     @(#)time.1      8.1 (Berkeley) %G%
.\"
.Dd
.Dt TIME 1
.Os BSD 4
.Sh NAME
.Nm time
.Nd time command execution
.Sh SYNOPSIS
.Nm time
.Op Fl l
.Ar command
.Sh DESCRIPTION
The
.Nm time
utility
executes and
times
.Ar command
by initiating a timer and passing the
.Ar command
to the
shell.
After the
.Ar command
finishes,
.Nm time
writes to the standard error stream,
(in seconds):
the total time elapsed,
time consumed by system overhead,
and the time used to execute the
.Ar command
process.
.Pp
Available options:
.Bl -tag -width Ds
.It Fl l
The contents of the
.Em rusage
structure are printed as well.
.El
.Pp
The
.Xr csh 1
has its own and syntactically different builtin version of
.Nm time.
The command described here
is available as
.Pa /usr/bin/time
to
.Xr csh
users.
.Sh BUGS
The granularity of seconds on micro processors is crude and
can result in times being reported for CPU usage which are too large by
a second.
.Sh SEE ALSO
.Xr csh 1
.Sh FILES
.Bl -tag -width /usr/include/sys/h/resource.h -compact
.It Pa /usr/include/sys/h/resource.h
.El
.Sh HISTORY
A
.Nm
command appeared in
.At v6 .