turbostat.8 (2f32edf12c1eafc8e5b1b0337360993fde1b3565) turbostat.8 (8e180f3cb6b7510a3bdf14e16ce87c9f5d86f102)
1.TH TURBOSTAT 8
2.SH NAME
3turbostat \- Report processor frequency and idle statistics
4.SH SYNOPSIS
5.ft B
6.B turbostat
1.TH TURBOSTAT 8
2.SH NAME
3turbostat \- Report processor frequency and idle statistics
4.SH SYNOPSIS
5.ft B
6.B turbostat
7.RB [ "\-s" ]
8.RB [ "\-v" ]
9.RB [ "\-m MSR#" ]
10.RB [ "\-M MSR#" ]
7.RB [ Options ]
11.RB command
12.br
13.B turbostat
8.RB command
9.br
10.B turbostat
14.RB [ "\-s" ]
15.RB [ "\-v" ]
16.RB [ "\-m MSR#" ]
17.RB [ "\-M MSR#" ]
11.RB [ Options ]
18.RB [ "\-i interval_sec" ]
19.SH DESCRIPTION
20\fBturbostat \fP reports processor topology, frequency
21and idle power state statistics on modern X86 processors.
22Either \fBcommand\fP is forked and statistics are printed
23upon its completion, or statistics are printed periodically.
24
25\fBturbostat \fP

--- 6 unchanged lines hidden (view full) ---

32The \fB-s\fP option limits output to a 1-line system summary for each interval.
33.PP
34The \fB-c\fP option limits output to the 1st thread in each core.
35.PP
36The \fB-p\fP option limits output to the 1st thread in each package.
37.PP
38The \fB-v\fP option increases verbosity.
39.PP
12.RB [ "\-i interval_sec" ]
13.SH DESCRIPTION
14\fBturbostat \fP reports processor topology, frequency
15and idle power state statistics on modern X86 processors.
16Either \fBcommand\fP is forked and statistics are printed
17upon its completion, or statistics are printed periodically.
18
19\fBturbostat \fP

--- 6 unchanged lines hidden (view full) ---

26The \fB-s\fP option limits output to a 1-line system summary for each interval.
27.PP
28The \fB-c\fP option limits output to the 1st thread in each core.
29.PP
30The \fB-p\fP option limits output to the 1st thread in each package.
31.PP
32The \fB-v\fP option increases verbosity.
33.PP
40The \fB-m MSR#\fP option dumps the specified 32-bit MSR,
41in addition to the usual frequency and idle statistics.
34The \fB-d MSR#\fP option includes the delta of the specified 32-bit MSR counter.
42.PP
35.PP
43The \fB-M MSR#\fP option dumps the specified 64-bit MSR,
44in addition to the usual frequency and idle statistics.
36The \fB-D MSR#\fP option includes the delta of the specified 64-bit MSR counter.
45.PP
37.PP
38The \fB-m MSR#\fP option includes the the specified 32-bit MSR value.
39.PP
40The \fB-M MSR#\fP option includes the the specified 64-bit MSR value.
41.PP
46The \fB-i interval_sec\fP option prints statistics every \fiinterval_sec\fP seconds.
47The default is 5 seconds.
48.PP
49The \fBcommand\fP parameter forks \fBcommand\fP and upon its exit,
50displays the statistics gathered since it was forked.
51.PP
52.SH FIELD DESCRIPTIONS
53.nf

--- 96 unchanged lines hidden (view full) ---

150Note that cpu1 and cpu7 are HT siblings within core8.
151As cpu7 is very busy, it prevents its sibling, cpu1,
152from entering a c-state deeper than c1.
153
154Note that turbostat reports average GHz of 3.63, while
155the arithmetic average of the GHz column above is lower.
156This is a weighted average, where the weight is %c0. ie. it is the total number of
157un-halted cycles elapsed per time divided by the number of CPUs.
42The \fB-i interval_sec\fP option prints statistics every \fiinterval_sec\fP seconds.
43The default is 5 seconds.
44.PP
45The \fBcommand\fP parameter forks \fBcommand\fP and upon its exit,
46displays the statistics gathered since it was forked.
47.PP
48.SH FIELD DESCRIPTIONS
49.nf

--- 96 unchanged lines hidden (view full) ---

146Note that cpu1 and cpu7 are HT siblings within core8.
147As cpu7 is very busy, it prevents its sibling, cpu1,
148from entering a c-state deeper than c1.
149
150Note that turbostat reports average GHz of 3.63, while
151the arithmetic average of the GHz column above is lower.
152This is a weighted average, where the weight is %c0. ie. it is the total number of
153un-halted cycles elapsed per time divided by the number of CPUs.
154.SH SMI COUNTING EXAMPLE
155On Intel Nehalem and newer processors, MSR 0x34 is a System Management Mode Interrupt (SMI) counter.
156Using the -m option, you can display how many SMIs have fired since reset, or if there
157are SMIs during the measurement interval, you can display the delta using the -d option.
158.nf
159[root@x980 ~]# turbostat -m 0x34
160cor CPU %c0 GHz TSC MSR 0x034 %c1 %c3 %c6 %pc3 %pc6
161 1.41 1.82 3.38 0x00000000 8.92 37.82 51.85 17.37 0.55
162 0 0 3.73 2.03 3.38 0x00000055 1.72 48.25 46.31 17.38 0.55
163 0 6 0.14 1.63 3.38 0x00000056 5.30
164 1 2 2.51 1.80 3.38 0x00000056 15.65 29.33 52.52
165 1 8 0.10 1.65 3.38 0x00000056 18.05
166 2 4 1.16 1.68 3.38 0x00000056 5.87 24.47 68.50
167 2 10 0.10 1.63 3.38 0x00000056 6.93
168 8 1 3.84 1.91 3.38 0x00000056 1.36 50.65 44.16
169 8 7 0.08 1.64 3.38 0x00000056 5.12
170 9 3 1.82 1.73 3.38 0x00000056 7.59 24.21 66.38
171 9 9 0.09 1.68 3.38 0x00000056 9.32
172 10 5 1.66 1.65 3.38 0x00000056 15.10 50.00 33.23
173 10 11 1.72 1.65 3.38 0x00000056 15.05
174^C
175[root@x980 ~]#
176.fi
158.SH NOTES
159
160.B "turbostat "
161must be run as root.
162
163.B "turbostat "
164reads hardware counters, but doesn't write them.
165So it will not interfere with the OS or other programs, including

--- 39 unchanged lines hidden ---
177.SH NOTES
178
179.B "turbostat "
180must be run as root.
181
182.B "turbostat "
183reads hardware counters, but doesn't write them.
184So it will not interfere with the OS or other programs, including

--- 39 unchanged lines hidden ---