Skip to content

Commit 2b38afc

Browse files
committed
Merge tag 'turbostat-2025.09.09' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux
Pull turbostat updates from Len Brown: "tools/power turbostat: version 2025.09.09 - Probe and display L3 Cache topology - Add ability to average an added counter (useful for pre-integrated "counters", such as Watts) - Break the limit of 64 built-in counters - Assorted bug fixes and minor feature tweaks" * tag 'turbostat-2025.09.09' of git://git.kernel.org/pub/scm/linux/kernel/git/lenb/linux: tools/power turbostat: version 2025.09.09 tools/power turbostat: Handle non-root legacy-uncore sysfs permissions tools/power turbostat: standardize PER_THREAD_PARAMS tools/power turbostat: Fix DMR support tools/power turbostat: add format "average" for external attributes tools/power turbostat: delete GET_PKG() tools/power turbostat: probe and display L3 cache topology tools/power turbostat: Support more than 64 built-in-counters tools/power turbostat.8: Document Totl%C0, Any%C0, GFX%C0, CPUGFX% columns tools/power turbostat: Fix bogus SysWatt for forked program tools/power turbostat: Handle cap_get_proc() ENOSYS tools/power turbostat: Fix build with musl tools/power turbostat: verify arguments to params --show and --hide tools/power turbostat: regression fix: --show C1E%
2 parents b96ddbc + 5e98a5e commit 2b38afc

File tree

2 files changed

+554
-225
lines changed

2 files changed

+554
-225
lines changed

tools/power/x86/turbostat/turbostat.8

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,11 @@ name as necessary to disambiguate it from others is necessary. Note that option
4747
MSRs are read as 64-bits, u32 truncates the displayed value to 32-bits.
4848
default: u64
4949

50-
format: {\fBraw\fP | \fBdelta\fP | \fBpercent\fP}
50+
format: {\fBraw\fP | \fBdelta\fP | \fBpercent\fP | \fBaverage\fP}
5151
'raw' shows the MSR contents in hex.
5252
'delta' shows the difference in values during the measurement interval.
5353
'percent' shows the delta as a percentage of the cycles elapsed.
54+
'average' similar to raw, but also averaged for node/package summaries (or when using -S).
5455
default: delta
5556

5657
name: "name_string"
@@ -186,6 +187,14 @@ The system configuration dump (if --quiet is not used) is followed by statistics
186187
.PP
187188
\fBSAMAMHz\fP Instantaneous snapshot of what sysfs presents at the end of the measurement interval. From /sys/class/drm/card0/gt/gt1/rps_act_freq_mhz or /sys/class/drm/card0/device/tile0/gtN/freq0/act_freq depending on the graphics driver being used.
188189
.PP
190+
\fBTotl%C0\fP Weighted percentage of time that CPUs are busy. If N CPUs are busy during an interval, the percentage is N * 100%.
191+
.PP
192+
\fBAny%C0\fP Percentage of time that at least one CPU is busy.
193+
.PP
194+
\fBGFX%C0\fP Percentage of time that at least one GFX compute engine is busy.
195+
.PP
196+
\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.
197+
.PP
189198
\fBPkg%pc2, Pkg%pc3, Pkg%pc6, Pkg%pc7\fP percentage residency in hardware package idle states. These numbers are from hardware residency counters.
190199
.PP
191200
\fBPkgWatt\fP Watts consumed by the whole package.

0 commit comments

Comments
 (0)