unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

RUSAGE(8)                   System Manager's Manual                  RUSAGE(8)



NAME
       rusage - print resource usage for a command

SYNOPSIS
       rusage command

DESCRIPTION
       The  rusage command is similar to time(1V).  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.

EXAMPLE
       The example below shows the format of rusage output.

       example% rusage wc /usr/man/man1/csh (1)
       3045   13423   78071 /usr/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(2), as follows:

            ; lfB lfB lfB .  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  volun-
            tary 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  cur-
            rently 0

SEE ALSO
       csh(1), time(1V), getrusage(2)

BUGS
       When  the  command  being  timed is interrupted, the timing values dis-
       played may be inaccurate.



                                 02 April 1988                       RUSAGE(8)