SSUSAGE(1)                                                          SSUSAGE(1)



NAME
     ssusage - run a command, and print out the resources it used

SYNOPSIS
     ssusage command [args]

DESCRIPTION
     ssusage is a SpeedShop executable that runs a process from the given
     command and arguments, and prints out a summary of the resources used
     during the run.  It is used in exactly the same way as time(1), but
     prints additional information.

     The usage information is printed to stderr in the form:
      1.89 real, 0.04 user, 0.29 sys, 15 majf, 2 minf, 0 sw, 1 rb, 0 wb, 21 vcx, 38 icx 854, mxrss

     The real, user, and sys fields give the real-time, user-CPU time, and
     system-CPU time, respectively.

     majf gives major page faults, i.e., those causing physical I/O.

     minf gives minor page faults,  i.e., those requiring mapping only.

     sw gives process swaps.

     rb and wb give physical blocks read and written, respectively.  Note that
     these are attributed to the process which first requests a block, but do
     not necessarily directly correlate with the process' own I/O operations.

     vcx gives voluntary context switches, that is, those caused by the
     process' own actions.

     icx gives involuntary context switches, those caused by the scheduler.

     mxrss gives the maximum resident set size of the program, including any
     shared pages, in kilobytes.

     In addition, if the command terminates abnormally, a message to that
     effect is printed before the usage line.

SEE ALSO
     speedshop(1), getrusage(3)














                                                                        Page 1