Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 32e7024e authored by Len Brown's avatar Len Brown
Browse files

tools/power turbostat: Update turbostat(8) RAPL throttling column description 



Explain that this column may increment for some throttling causes,
and may not increment for others.

Signed-off-by: default avatarLen Brown <len.brown@intel.com>
parent 73780cd8

tools/power/x86/turbostat/turbostat.8

+2 −2
Original line number Diff line number Diff line
@@ -106,7 +106,7 @@ The system configuration dump (if --quiet is not used) is followed by statistics 
\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.

\fBCPU%c1, CPU%c3, CPU%c6, CPU%c7\fP show the percentage residency in hardware core idle states.  These numbers are from hardware residency counters.

\fBCoreTmp\fP Degrees Celsius reported by the per-core Digital Thermal Sensor.

\fBPkgTtmp\fP Degrees Celsius reported by the per-package Package Thermal Monitor.

\fBPkgTmp\fP Degrees Celsius reported by the per-package Package Thermal Monitor.

\fBGFX%rc6\fP The percentage of time the GPU is in the "render C6" state, rc6, during the measurement interval. From /sys/class/drm/card0/power/rc6_residency_ms.

\fBGFXMHz\fP Instantaneous snapshot of what sysfs presents at the end of the measurement interval. From /sys/class/graphics/fb0/device/drm/card0/gt_cur_freq_mhz.

\fBPkg%pc2, Pkg%pc3, Pkg%pc6, Pkg%pc7\fP percentage residency in hardware package idle states.  These numbers are from hardware residency counters.
@@ -114,7 +114,7 @@ The system configuration dump (if --quiet is not used) is followed by statistics 
\fBCorWatt\fP Watts consumed by the core part of the package.

\fBGFXWatt\fP Watts consumed by the Graphics part of the package -- available only on client processors.

\fBRAMWatt\fP Watts consumed by the DRAM DIMMS -- available only on server processors.

\fBPKG_%\fP percent of the interval that RAPL throttling was active on the Package.

\fBPKG_%\fP percent of the interval that RAPL throttling was active on the Package.  Note that the system summary is the sum of the package throttling time, and thus may be higher than 100% on a multi-package system.  Note that the meaning of this field is model specific.  For example, some hardware increments this counter when RAPL responds to thermal limits, but does not increment this counter when RAPL responds to power limits.  Comparing PkgWatt and PkgTmp to system limits is necessary.

\fBRAM_%\fP percent of the interval that RAPL throttling was active on DRAM.

.fi

.SH TOO MUCH INFORMATION EXAMPLE