cpustat(1)
Name
cpustat − report CPU statistics
Syntax
cpustat [−cfhs] [interval] [count]
Description
The cpustat command displays statistics about each CPU in the system. A full screen interface is provided, and the display is updated at intervals specified by the user. If interval is specified, then successive updates are summaries over the last interval seconds. If count is specified, the statistics and/or the state are repeated count times.
The display format fields are:
Statistics : Information about how each CPU’s time is being utilized
us% Percent of time spent in user mode
ni% Percent of time spent in nice mode
sy% Percent of time spent in system mode
id% Percent of time spent idle by the CPU
csw Number of context switches
sys Number of system calls
trap Number of traps
intr Number of device interrupts
ipi Number of inter processor interrupts
ttyin Number of characters input through tty
ttyout Number of character output through tty
State : Information about different states of each CPU
cpuid Unique identifier of the CPU
state CPU state:
B - boot CPU
D - disable soft errors
S - stopped
R - running
T - TB needs invalidation
P - panicked
ipi-mask interprocessor interupt mask:
P - panic
R - console print
S - schedule
D - disable
T - TB invalidation
H - stop CPU
proc Indicates if the CPU has an associated process (Y/N)
pid Process id of the running process
If any statistic field value exceeds 9999, it is shown in a scaled representation with the suffix k, which indicates multiplication by 1000, or with the suffix m, which indicates multiplication by 1000000. For example, the value 12345 would appear as 12k.
Options
−cDisplays state information about each CPU.
−fDisplays statistics and state information on a full screen. If the −f option is used, the following commands can be entered from the screen:
cDisplay only state information about each CPU
dGo to the default mode of display
hDisplay the help screen. Typing any character while on the help screen will display the original screen.
sDisplay only statistics
−sDisplays statistics about each CPU in the system.
−hProvides help information about the usage of cpustat.
If none of the options are specified, cpustat will report a summary of the statistics since the system has been booted and the state of each CPU.
Examples
To print the system status every five seconds ten times, type the following:
% cpustat 5 10
Files
/dev/kmem
/vmunix