rusage(1B)

NAME

     rusage - print resource usage for a command

SYNOPSIS

     /usr/ucb/rusage command

DESCRIPTION

     The rusage command is similar to time(1). It runs the  given
     command,  which  must  be specified; that is, command is not
     optional as it is in the C shell's timing facility. When the
     command  is complete, rusage displays the real (wall clock),
     the system CPU, and the user CPU times which elapsed  during
     execution  of  the  command, plus other fields in the rusage
     structure, all on one  long  line.  Times  are  reported  in
     seconds and hundredths of a second.

EXAMPLES

     Example 1: The format of rusage output

     The example below shows the format of rusage output.

     example% rusage wc /usr/share/man/man1/csh (1)
     3045   13423   78071 /usr/share/man/man1/csh (1)
     2.26 real 0.80 user 0.36 sys 11 pf 38 pr 0 sw 11 rb 0 wb 16 vcx 37
              icx 24 mx 0 ix 1230 id 9 is
     example%

     Each of the fields identified corresponds to an  element  of
     the rusage structure, as described in getrusage(3C), as fol-
     lows:

     real                       elapsed real time
     user      ru_utime         user time used
     sys       ru_stime         system time used
     pf        ru_majflt        page faults requiring physical I/O
     pr        ru_minflt        page faults not requiring physical
                                I/O
     sw        ru_nswap         swaps
     rb        ru_inblock       block input operations
     wb        ru_oublock       block output operations
     vcx       ru_nvcsw         voluntary context switches
     icx       ru_nivcsw        involuntary context switches
     mx        ru_maxrss        maximum resident set size
     ix        ru_ixrss         currently 0
     id        ru_idrss         integral resident set size
     is        ru_isrss         currently 0

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWscpu                    |
    |_____________________________|_____________________________|

SEE ALSO

     csh(1), time(1), getrusage(3C), attributes(5)

BUGS

     When the command being  timed  is  interrupted,  the  timing
     values displayed may be inaccurate.