cpustat(1)
Name
cpustat − report CPU statistics
Syntax
cpustat [−cfhsv] [interval [count]]
Description
The cpustat command displays statistics about the use and state of each CPU in the system. The information about the CPU might change while the cpustat command is running, so the information it gives is a snapshot taken at a given time.
Normally, the cpustat 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 cpustat 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 cpustat command repeats the display by specifying an integer in the count argument.
The cpustat command provides an interactive interface that you can invoke using the −f option.
The following describes the fields in the cpustat 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
−cDisplays only the statistics for each CPU.
−fDisplays statistics and state information on a full screen. If you use the −f option, you are prompted to enter one of the following commands:
cDisplays only statistics about each CPU.
dUses the default mode of display.
hDisplays the help screen. To return to the original display screen, enter any character.
qQuits from the full screen display.
sDisplays only state information about each CPU.
vDisplays information about each vector processor and omits information about other processors.
−sDisplays only state information about each CPU.
−hProvides help information about the usage of the cpustat command.
−vDisplays information about each vector processor and omits information about other processors. When cpustat displays information about vector processors, it adds the following information to the display:
vp stateIndicates that the vector processor is operational (OK), not usable (DEAD), enabled (ENA), or disabled (DIS). The cpustat command display may contain a combination of these states.
vp ownerPID of the vector process whose context is stored in the vector processor.
chp cxswNumber 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 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 cxswNumber 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 reqNumber of times the vector process has successfully allocated the vector processor.
failed reqNumber of times the vector process has been refused vector processor allocation.
If you omit all options, cpustat 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 following command:
% cpustat 5 10
Files
/dev/kmem Virtual main memory image
/vmunix System namelist