NAME    [Toc]    [Back]

     time - time command execution

SYNOPSIS    [Toc]    [Back]

     time [-lp] utility

DESCRIPTION    [Toc]    [Back]

     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:

     -l      The contents of the rusage structure are printed.

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

     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    [Toc]    [Back]

     /usr/include/sys/resource.h

SEE ALSO    [Toc]    [Back]

     csh(1), sh(1), getrusage(2)

STANDARDS    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

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

BUGS    [Toc]    [Back]

     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.6                           June      6,      1993