TIME(1)                    OpenBSD Reference Manual                    TIME(1)

NAME
     time - time command execution

SYNOPSIS
     time [-lp] utility

DESCRIPTION
     time executes and times utility. After the utility finishes, time writes
     the total time elapsed, the time consumed by system overhead, and the
     time used to execute utility to the standard error stream.  Times are re-
     ported in seconds.

     The options are as follows:

     -l      The contents of the rusage structure are printed.

     -p      The output is formatted as specified by IEEE Std1003.2-1992
             (``POSIX.2'').

     csh(1) has its own and syntactically different built-in version of time.
     The utility described here is available as /usr/bin/time to csh users.

     The time utility shall exit with one of the following values:

     1-125   An error occurred in the time utility.
     126     The utility was found but could not be invoked.
     127     The utility could not be found.

     Otherwise, the exit status of time shall be that of utility.

FILES
     /usr/include/sys/resource.h

SEE ALSO
     csh(1), getrusage(2)

STANDARDS
     The time utility conforms to IEEE Std1003.2-1992 (``POSIX.2'').

HISTORY
     A time command appeared in Version 6 AT&T UNIX.

BUGS
     The granularity of seconds on microprocessors is crude and can result in
     times being reported for CPU usage which are too large by a second.

OpenBSD 3.0                      June 6, 1993                                1
