xref: /freebsd/usr.bin/time/time.1 (revision 80c486a414a506ad9850ca9317feb3763ac81fdc)
19b50d902SRodney W. Grimes.\" Copyright (c) 1980, 1991, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"     @(#)time.1	8.1 (Berkeley) 6/6/93
339b50d902SRodney W. Grimes.\"
349b50d902SRodney W. Grimes.Dd June 6, 1993
359b50d902SRodney W. Grimes.Dt TIME 1
369b50d902SRodney W. Grimes.Os BSD 4
379b50d902SRodney W. Grimes.Sh NAME
389b50d902SRodney W. Grimes.Nm time
399b50d902SRodney W. Grimes.Nd time command execution
409b50d902SRodney W. Grimes.Sh SYNOPSIS
4180c486a4SPhilippe Charnier.Nm
429b50d902SRodney W. Grimes.Op Fl l
439b50d902SRodney W. Grimes.Ar command
449b50d902SRodney W. Grimes.Sh DESCRIPTION
459b50d902SRodney W. GrimesThe
4680c486a4SPhilippe Charnier.Nm
479b50d902SRodney W. Grimesutility
489b50d902SRodney W. Grimesexecutes and
499b50d902SRodney W. Grimestimes
509b50d902SRodney W. Grimes.Ar command
519b50d902SRodney W. Grimesby initiating a timer and passing the
529b50d902SRodney W. Grimes.Ar command
539b50d902SRodney W. Grimesto the
549b50d902SRodney W. Grimesshell.
559b50d902SRodney W. GrimesAfter the
569b50d902SRodney W. Grimes.Ar command
579b50d902SRodney W. Grimesfinishes,
5880c486a4SPhilippe Charnier.Nm
599b50d902SRodney W. Grimeswrites to the standard error stream,
609b50d902SRodney W. Grimes(in seconds):
619b50d902SRodney W. Grimesthe total time elapsed,
629b50d902SRodney W. Grimestime consumed by system overhead,
639b50d902SRodney W. Grimesand the time used to execute the
649b50d902SRodney W. Grimes.Ar command
659b50d902SRodney W. Grimesprocess.
669b50d902SRodney W. Grimes.Pp
679b50d902SRodney W. GrimesAvailable options:
689b50d902SRodney W. Grimes.Bl -tag -width Ds
699b50d902SRodney W. Grimes.It Fl l
709b50d902SRodney W. GrimesThe contents of the
719b50d902SRodney W. Grimes.Em rusage
729b50d902SRodney W. Grimesstructure are printed as well.
739b50d902SRodney W. Grimes.El
749b50d902SRodney W. Grimes.Pp
759b50d902SRodney W. GrimesThe
769b50d902SRodney W. Grimes.Xr csh 1
779b50d902SRodney W. Grimeshas its own and syntactically different builtin version of
789b50d902SRodney W. Grimes.Nm time .
799b50d902SRodney W. GrimesThe command described here
809b50d902SRodney W. Grimesis available as
819b50d902SRodney W. Grimes.Pa /usr/bin/time
829b50d902SRodney W. Grimesto
839b50d902SRodney W. Grimes.Xr csh
849b50d902SRodney W. Grimesusers.
859b50d902SRodney W. Grimes.Sh BUGS
869b50d902SRodney W. GrimesThe granularity of seconds on micro processors is crude and
879b50d902SRodney W. Grimescan result in times being reported for CPU usage which are too large by
889b50d902SRodney W. Grimesa second.
899b50d902SRodney W. Grimes.Sh SEE ALSO
906836c26dSMike Pritchard.Xr csh 1 ,
916836c26dSMike Pritchard.Xr getrusage 2 ,
926836c26dSMike Pritchard.Xr wait 2
939b50d902SRodney W. Grimes.Sh HISTORY
949b50d902SRodney W. GrimesA
959b50d902SRodney W. Grimes.Nm
969b50d902SRodney W. Grimescommand appeared in
979b50d902SRodney W. Grimes.At v6 .
98