TIME(1CSH)              COMMAND REFERENCE              TIME(1CSH)



NAME
     time - print time statistics (csh built-in)

SYNOPSIS
     time [ command [ args... ] ]

DESCRIPTION
     With no arguments, time prints a summary of the times used
     by the current shell and all of its child processes.  With a
     command argument, the command is executed and the time
     summary is printed for that command execution.

     The time shell variable may be set to contain a minumum
     amount of CPU time used by a process to cause a time summary
     to be printed automatically, and a summary format.

     The summary format is controlled by the value of the second
     element of the time variable.  The format is a string which
     may contain text, and the following special value
     identifiers, which cause the given values to be printed.


          %U    user time
          %S    system time
          %E    elapsed time
          %P    average percentage of CPU cycles used
          %W    number of swaps
          %X    text segment resident set size (in kilobytes)
          %D    data segment resident set size (in kilobytes)
          %K    total resident set size (in kilobytes)
          %M    maximum resident set size (in kilobytes)
          %F    major page faults
          %R    minor page faults
          %I    blocks read
          %O    blocks written

     The default summary format is ``%Uu %Ss %E %P %X+%Dk %I+%Oio
     %Fpf+%Ww''.

     The command must be a simple command, not an alias or
     control statement.  If necessary, a separate shell is
     created to print the summary.

EXAMPLES
     The following example runs the command ``make myprog'' and
     prints a time summary after the command has completed.



          time make myprog





Printed 10/17/86                                                1

TIME(1CSH)              COMMAND REFERENCE              TIME(1CSH)



     The following setting of the time variable will cause all
     processes that use more than 5 seconds of CPU time to have
     an automatic time summary printed.  The summary will contain
     the user, system, and elapsed times.



          set time=(5 "%U user  %S system  %E elapsed")


RETURN VALUE
     The return value is the value returned by the command
     executed (0 if none given), or 1 if the command does not
     exist.

SEE ALSO
     @(1csh), alias(1csh), bg(1csh), break(1csh), cd(1csh),
     chdir(1csh), continue(1csh), csh(1csh), dirs(1csh),
     echo(1csh), eval(1csh), exec(1csh), exit(1csh), fg(1csh),
     glob(1csh), goto(1csh), hashstat(1csh), history(1csh),
     jobs(1csh), kill(1csh), limit(1csh), logout(1csh),
     nice(1csh), nohup(1csh), notify(1csh), onintr(1csh),
     popd(1csh), pushd(1csh), rehash(1csh), repeat(1csh),
     set(1csh), setenv(1csh), sh(1sh), shift(1csh), source(1csh),
     stop(1csh), suspend(1csh), time(1), times(1sh), umask(1csh),
     unhash(1csh), unalias(1csh), unlimit(1csh), unset(1csh),
     unsetenv(1csh), wait(1csh), which(1csh), getitimer(2),
     setitimer(2), getrusage(2).



























Printed 10/17/86                                                2

%%index%%
na:72,97;
sy:169,138;
de:307,1593;
ex:1900,213;2257,304;
rv:2561,213;
se:2774,1652;
%%index%%000000000117