1MPSTAT(1) Linux User's Manual MPSTAT(1)
2
6 mpstat - Report processors related statistics.
7
9 mpstat [ -A ] [ -u ] [ -V ] [ -I { SUM | CPU | SCPU | ALL } ] [ -P {
10 cpu [,...] | ON | ALL } ] [ interval [ count ] ]
11
13 The mpstat command writes to standard output activities for each avail‐
14 able processor, processor 0 being the first one. Global average activ‐
15 ities among all processors are also reported. The mpstat command can
16 be used both on SMP and UP machines, but in the latter, only global
17 average activities will be printed. If no activity has been selected,
18 then the default report is the CPU utilization report.
19 The interval parameter specifies the amount of time in seconds between
21 each report. A value of 0 (or no parameters at all) indicates that
22 processors statistics are to be reported for the time since system
23 startup (boot). The count parameter can be specified in conjunction
24 with the interval parameter if this one is not set to zero. The value
25 of count determines the number of reports generated at interval seconds
26 apart. If the interval parameter is specified without the count parame‐
27 ter, the mpstat command generates reports continuously.
28
31 -A This option is equivalent to specifying -u -I ALL -P ALL
32 -I { SUM | CPU | SCPU | ALL }
34 Report interrupts statistics.
35 With the SUM keyword, the mpstat command reports the total num‐
37 ber of interrupts per processor. The following values are dis‐
38 played:
39 CPU
41 Processor number. The keyword all indicates that statis‐
42 tics are calculated as averages among all processors.
43 intr/s
45 Show the total number of interrupts received per second
46 by the CPU or CPUs.
47 With the CPU keyword, the number of each individual interrupt
49 received per second by the CPU or CPUs is displayed.
50 With the SCPU keyword, the number of each individual software
52 interrupt received per second by the CPU or CPUs is displayed.
53 This option works only with kernels 2.6.31 and later.
54 The ALL keyword is equivalent to specifying all the keywords
56 above and therefore all the interrupts statistics are displayed.
57 -P { cpu [,...] | ON | ALL }
59 Indicate the processor number for which statistics are to be
60 reported. cpu is the processor number. Note that processor 0 is
61 the first processor. The ON keyword indicates that statistics
62 are to be reported for every online processor, whereas the ALL
63 keyword indicates that statistics are to be reported for all
64 processors.
65 -u Report CPU utilization. The following values are displayed:
67 CPU
69 Processor number. The keyword all indicates that statis‐
70 tics are calculated as averages among all processors.
71 %usr
73 Show the percentage of CPU utilization that occurred
74 while executing at the user level (application).
75 %nice
77 Show the percentage of CPU utilization that occurred
78 while executing at the user level with nice priority.
79 %sys
81 Show the percentage of CPU utilization that occurred
82 while executing at the system level (kernel). Note that
83 this does not include time spent servicing hardware and
84 software interrupts.
85 %iowait
87 Show the percentage of time that the CPU or CPUs were
88 idle during which the system had an outstanding disk I/O
89 request.
90 %irq
92 Show the percentage of time spent by the CPU or CPUs to
93 service hardware interrupts.
94 %soft
96 Show the percentage of time spent by the CPU or CPUs to
97 service software interrupts.
98 %steal
100 Show the percentage of time spent in involuntary wait by
101 the virtual CPU or CPUs while the hypervisor was servic‐
102 ing another virtual processor.
103 %guest
105 Show the percentage of time spent by the CPU or CPUs to
106 run a virtual processor.
107 %gnice
109 Show the percentage of time spent by the CPU or CPUs to
110 run a niced guest.
111 %idle
113 Show the percentage of time that the CPU or CPUs were
114 idle and the system did not have an outstanding disk I/O
115 request.
116 Note: On SMP machines a processor that does not have any activ‐
118 ity at all is a disabled (offline) processor.
119 -V Print version number then exit.
121
124 The mpstat command takes into account the following environment vari‐
125 able:
126 S_TIME_FORMAT
129 If this variable exists and its value is ISO then the current
130 locale will be ignored when printing the date in the report
131 header. The mpstat command will use the ISO 8601 format (YYYY-
132 MM-DD) instead.
133
136 mpstat 2 5
137 Display five reports of global statistics among all processors
138 at two second intervals.
139 mpstat -P ALL 2 5
141 Display five reports of statistics for all processors at two
142 second intervals.
143
146 /proc filesystem must be mounted for the mpstat command to work.
147 Only a few activities are given by the Linux kernel for each processor.
149
152 /proc contains various files with system statistics.
153
156 Sebastien Godard (sysstat <at> orange.fr)
157
159 sar(1), pidstat(1), iostat(1), vmstat(8)
160 http://pagesperso-orange.fr/sebastien.godard/
162Linux SEPTEMBER 2012 MPSTAT(1)