RUSAGE(8) — MAINTENANCE COMMANDS
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:
| 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 |
SEE ALSO
csh(1), time(1V), getrusage(2)
BUGS
When the command being timed is interrupted, the timing values displayed may be inaccurate.
Solbourne Computer, Inc. — 02 April 1988