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

     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.



Printed 5/12/88                                                 1

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



          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), and getrusage(2).



































Printed 5/12/88                                                 2

%%index%%
na:312,125;
sy:437,186;
de:623,1639;
ex:2262,485;3131,57;
rv:3188,257;
se:3445,1692;
%%index%%000000000118