1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)time.1 8.1 (Berkeley) 06/06/93 7.\" 8.Dd 9.Dt TIME 1 10.Os BSD 4 11.Sh NAME 12.Nm time 13.Nd time command execution 14.Sh SYNOPSIS 15.Nm time 16.Op Fl l 17.Ar command 18.Sh DESCRIPTION 19The 20.Nm time 21utility 22executes and 23times 24.Ar command 25by initiating a timer and passing the 26.Ar command 27to the 28shell. 29After the 30.Ar command 31finishes, 32.Nm time 33writes to the standard error stream, 34(in seconds): 35the total time elapsed, 36time consumed by system overhead, 37and the time used to execute the 38.Ar command 39process. 40.Pp 41Available options: 42.Bl -tag -width Ds 43.It Fl l 44The contents of the 45.Em rusage 46structure are printed as well. 47.El 48.Pp 49The 50.Xr csh 1 51has its own and syntactically different builtin version of 52.Nm time. 53The command described here 54is available as 55.Pa /usr/bin/time 56to 57.Xr csh 58users. 59.Sh BUGS 60The granularity of seconds on micro processors is crude and 61can result in times being reported for CPU usage which are too large by 62a second. 63.Sh SEE ALSO 64.Xr csh 1 65.Sh FILES 66.Bl -tag -width /usr/include/sys/h/resource.h -compact 67.It Pa /usr/include/sys/h/resource.h 68.El 69.Sh HISTORY 70A 71.Nm 72command appeared in 73.At v6 . 74