TIME(1)                 System General Commands Manual                 TIME(1)

NAME
     time - time command execution

SYNOPSIS
     time [-p] 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
     reported in seconds.

     The options are as follows:

     -p      The output is formatted as specified by IEEE Std 1003.2-1992
             (``POSIX.2'') and SUS.

     The time utility exists as a built-in to most shells, although they may
     be syntactically different.  The utility described here is available as
     /usr/bin/time.

     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), sh(1), getrusage(2)

STANDARDS
     The time utility conforms to IEEE Std 1003.2-1992 (``POSIX.2'') and SUS.

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

NOTES
     This is a standalone utility and may not provide identical information to
     the built-in commands with the csh and sh shells -- notably when a set of
     commands are invoked with a pipeline.

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.

Interix                          June 26, 2006                         Interix