.TH TIME 1
.SH NAME
time \- report how long a command takes
.SH SYNOPSIS
\fBtime [-C] \fIcommand\fR
.br
.de FL
.TP
\\fB\\$1\\fR
\\$2
..
.de EX
.TP 20
\\fB\\$1\\fR
# \\$2
..
The -C option tells time to report the cpu cycle counter
difference.
.SH EXAMPLES
.TP 20
.B time a.out
# Report how long \fIa.out\fR takes
.TP 20
.B time ls \-l *.c
# Report how long \fIls\fR takes
.SH DESCRIPTION
.PP
The command is executed and the real time, user time, and system time (in
hours, minutes, and seconds) are printed.
Shell scripts cannot be timed.
.SH "SEE ALSO"
.BR times (2).