cpustat(1)cpustat(1)Namecpustat - report CPU statistics
Syntaxcpustat [-cfhsv] [interval [count]]
Description
The command displays statistics about the use and state of each CPU in
the system. The information about the CPU might change while the com‐
mand 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 the
terminal.
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 indicates 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.
Options-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 fol‐
lowing commands:
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 infor‐
mation about other processors. When displays information about
vector processors, it adds the following information to the dis‐
play:
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 processor. Because no other process uses the vec‐
tor 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 pro‐
cesses might be using the same vector processor. When
more than one process uses the same processor, the reg‐
ister 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.
failed req
Number of times the vector process has been refused vec‐
tor 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.
Examples
To print the system status every five seconds ten times, enter the fol‐
lowing command:
% cpustat 5 10
Files
Virtual main memory image
System namelist
See Alsoiostat(1), vmstat(1)cpustat(1)
