cpustat(1) General Commands Manual cpustat(1)
cpustat - report CPU statistics
cpustat [-cfhsv] [interval [count]]
The command displays statistics about the use and state of each CPU in the system. The information about the CPU might change while the
command is running, so the information it gives is a snapshot taken at a given time.
Normally, the command displays the statistics and state only once. You can cause the command to repeat the display by specifying a decimal
number in the interval argument. The command repeats the display until it is interrupted, for example, by a control character entered at
You can limit the number of times the command repeats the display by specifying an integer in the count argument.
The command provides an interactive interface that you can invoke using the -f option.
The following describes the fields in the display:
Statistics: Information about how each CPU's time is being used
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
csw Number of context switches
sys Number of system calls
trap Number of traps
intr Number of device interrupts
ipi Number of interprocessor interrupts
ttyin Number of characters input to the terminal
ttyout Number of characters output to the terminal
State: Information about the 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 interrupt mask
P - panic
R - console print
S - schedule
D - disable
T - TB invalidation
H - stop CPU
proc Indication of whether the CPU has an associated process. A Y indicates that an associated process exists, while an N indi-
cates that no associated process exists.
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 1,000,000. For example, the value 12,345 would appear as 12k.
-c Displays only the statistics for each CPU.
-f Displays statistics and state information on a full screen. If you use the -f option, you are prompted to enter one of the following
c Displays only statistics about each CPU.
d Uses the default mode of display.
h Displays the help screen. To return to the original display screen, enter any character.
q Quits from the full screen display.
s Displays only state information about each CPU.
v Displays information about each vector processor and omits information about other processors.
-s Displays only state information about each CPU.
-h Provides help information about the usage of the command.
-v Displays information about each vector processor and omits information about other processors. When displays information about vector
processors, it adds the following information to the display:
vp state Indicates that the vector processor is operational (OK), not usable (DEAD), enabled (ENA), or disabled (DIS). The command
display may contain a combination of these states.
vp owner PID of the vector process whose context is stored in the vector processor.
chp cxsw Number of context switches in which the process whose context changed is the only process using a particular vector proces-
sor. Because no other process uses the vector processor, the register data associated with the processor does not change.
Therefore, the system does not need to save and restore the register data; the data remains in the registers until the
process is ready to use it.
exp cxsw Number of context switches in which a number of processes might be using the same vector processor. When more than one
process uses the same processor, the register data associated with the processor might be changed by any process. Therefore,
the system saves and restores the register data during a context switch for any process.
succ req Number of times the vector process has successfully allocated the vector processor.
Number of times the vector process has been refused vector processor allocation.
If you omit all options, reports a summary of the statistics since the system has been booted and the state of each CPU.
To print the system status every five seconds ten times, enter the following command:
% cpustat 5 10
Virtual main memory image