Copyright (c) 2003, Sun Microsystems, Inc.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
/usr/ucb/rusage command
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.
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 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 |
csh(1), time(1), getrusage(3C), attributes(5)
When the command being timed is interrupted, the timing values displayed may be inaccurate.