Skip to content

Commit 785953c

Browse files
committed
tools/power turbostat.8: Document the "--force" option
Starting in turbostat v2025.01.14, turbostat refused to run on unsupported hardware, pointing to "RUN THE LATEST VERSION" on turbostat(8). At that time, turbostat supported and advertised the "--force" parameter to run anyway (with unsupported results). Also document "--force" on turbostat.8. Signed-off-by: Len Brown <len.brown@intel.com>
1 parent d0f7093 commit 785953c

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

tools/power/x86/turbostat/turbostat.8

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,8 @@ The column name "all" can be used to enable all disabled-by-default built-in cou
111111
.PP
112112
\fB--no-perf\fP Disable all the uses of the perf API.
113113
.PP
114+
\fB--force\fPForce turbostat to run on an unsupported platform (minimal defaults).
115+
.PP
114116
\fB--interval seconds\fP overrides the default 5.0 second measurement interval.
115117
.PP
116118
\fB--num_iterations num\fP number of the measurement iterations.
@@ -165,9 +167,9 @@ The system configuration dump (if --quiet is not used) is followed by statistics
165167
.PP
166168
\fBC1, C2, C3...\fP The number times Linux requested the C1, C2, C3 idle state during the measurement interval. The system summary line shows the sum for all CPUs. These are C-state names as exported in /sys/devices/system/cpu/cpu*/cpuidle/state*/name. While their names are generic, their attributes are processor specific. They the system description section of output shows what MWAIT sub-states they are mapped to on each system. These counters are in the "cpuidle" group, which is disabled, by default.
167169
.PP
168-
\fBC1+, C2+, C3+...\fP The idle governor idle state misprediction statistics. Inidcates the number times Linux requested the C1, C2, C3 idle state during the measurement interval, but should have requested a deeper idle state (if it exists and enabled). These statistics come from the /sys/devices/system/cpu/cpu*/cpuidle/state*/below file. These counters are in the "cpuidle" group, which is disabled, by default.
170+
\fBC1+, C2+, C3+...\fP The idle governor idle state misprediction statistics. Indicates the number times Linux requested the C1, C2, C3 idle state during the measurement interval, but should have requested a deeper idle state (if it exists and enabled). These statistics come from the /sys/devices/system/cpu/cpu*/cpuidle/state*/below file. These counters are in the "cpuidle" group, which is disabled, by default.
169171
.PP
170-
\fBC1-, C2-, C3-...\fP The idle governor idle state misprediction statistics. Inidcates the number times Linux requested the C1, C2, C3 idle state during the measurement interval, but should have requested a shallower idle state (if it exists and enabled). These statistics come from the /sys/devices/system/cpu/cpu*/cpuidle/state*/above file. These counters are in the "cpuidle" group, which is disabled, by default.
172+
\fBC1-, C2-, C3-...\fP The idle governor idle state misprediction statistics. Indicates the number times Linux requested the C1, C2, C3 idle state during the measurement interval, but should have requested a shallower idle state (if it exists and enabled). These statistics come from the /sys/devices/system/cpu/cpu*/cpuidle/state*/above file. These counters are in the "cpuidle" group, which is disabled, by default.
171173
.PP
172174
\fBC1%, C2%, C3%\fP The residency percentage that Linux requested C1, C2, C3.... The system summary is the average of all CPUs in the system. Note that these are software, reflecting what was requested. The hardware counters reflect what was actually achieved. These counters are in the "pct_idle" group, which is enabled by default.
173175
.PP
@@ -197,7 +199,7 @@ The system configuration dump (if --quiet is not used) is followed by statistics
197199
.PP
198200
\fBGFX%C0\fP Percentage of time that at least one GFX compute engine is busy.
199201
.PP
200-
\fBCPUGFX%\fP Percentage of time that at least one CPU is busy at the same time as at least one Graphics compute enginer is busy.
202+
\fBCPUGFX%\fP Percentage of time that at least one CPU is busy at the same time as at least one Graphics compute engine is busy.
201203
.PP
202204
\fBPkg%pc2, Pkg%pc3, Pkg%pc6, Pkg%pc7\fP percentage residency in hardware package idle states. These numbers are from hardware residency counters.
203205
.PP
@@ -559,6 +561,8 @@ If the upstream version isn't new enough, the development tree can be found here
559561
If the development tree doesn't work, please contact the author via chat,
560562
or via email with the word "turbostat" on the Subject line.
561563

564+
An old turbostat binary may run on unknown hardware by using "--force",
565+
but results are unsupported.
562566
.SH FILES
563567
.ta
564568
.nf

0 commit comments

Comments
 (0)