You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: tools/power/x86/turbostat/turbostat.8
+7-3Lines changed: 7 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -111,6 +111,8 @@ The column name "all" can be used to enable all disabled-by-default built-in cou
111
111
.PP
112
112
\fB--no-perf\fP Disable all the uses of the perf API.
113
113
.PP
114
+
\fB--force\fPForce turbostat to run on an unsupported platform (minimal defaults).
115
+
.PP
114
116
\fB--intervalseconds\fP overrides the default 5.0 second measurement interval.
115
117
.PP
116
118
\fB--num_iterationsnum\fP number of the measurement iterations.
@@ -165,9 +167,9 @@ The system configuration dump (if --quiet is not used) is followed by statistics
165
167
.PP
166
168
\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.
167
169
.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.
169
171
.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.
171
173
.PP
172
174
\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.
173
175
.PP
@@ -197,7 +199,7 @@ The system configuration dump (if --quiet is not used) is followed by statistics
197
199
.PP
198
200
\fBGFX%C0\fP Percentage of time that at least one GFX compute engine is busy.
199
201
.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.
201
203
.PP
202
204
\fBPkg%pc2,Pkg%pc3,Pkg%pc6,Pkg%pc7\fP percentage residency in hardware package idle states. These numbers are from hardware residency counters.
203
205
.PP
@@ -559,6 +561,8 @@ If the upstream version isn't new enough, the development tree can be found here
559
561
If the development tree doesn't work, please contact the author via chat,
560
562
or via email with the word "turbostat" on the Subject line.
561
563
564
+
An old turbostat binary may run on unknown hardware by using "--force",
0 commit comments