SunOS/BSD Compatibility Package Commands               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      ruutime         user time used
     sys       rustime         system time used
     pf        rumajflt        page faults requiring physical I/O
     pr        ruminflt        page faults not requiring physical I/O
     sw        runswap         swaps
     rb        ruinblock       block input operations
     wb        ruoublock       block output operations
     vcx       runvcsw         voluntary context switches
     icx       runivcsw        involuntary context switches
     mx        rumaxrss        maximum resident set size
     ix        ruixrss         currently 0



SunOS 5.11          Last change: 14 Sep 1992                    1






SunOS/BSD Compatibility Package Commands               rusage(1B)



     id        ruidrss         integral resident set size
     is        ruisrss         currently 0


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



     
           ATRIBUTE TYPE               ATRIBUTE 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.
































SunOS 5.11          Last change: 14 Sep 1992                    2