LIBPFM(3) Linux Programmer's ManualLIBPFM(3)libpfm_intel_rapl - support for Intel RAPL PMU
#include <perfmon/pfmlib.h>PMU name: raplPMU desc: Intel RAPL (Intel SandyBridge, IvyBridge, Haswell)
The library supports the Intel Running Average Power Limit (RAPL) energy consumption counters. This is a socket-level set of counters which reports energy consumption in Joules. There are up to 3 counters each measuring only one event. The following events are defined:RAPL_ENERGY_CORES On all processors, the event reports the number of Joules consumed by all cores. On all processors,RAPL_ENERGYC_PKG On all processors, th event reports the number of Joules consumed by all the cores and Last Level cache (L3).RAPL_ENERGY_DRAM On server processors, the event reports the number of Joules consumed n by the DRAM controller. By construction, the events are socket-level and can only be measured in system-wide mode. It is necessary and sufficient to measure only one CPU per socket to get meaningful results.
The PMU does not support any modifiers.
Stephane Eranian <eranian@gmail.com>
This page is part of theperfmon2 (a performance monitoring library) project. Information about the project can be found at ⟨http://perfmon2.sourceforge.net/⟩. If you have a bug report for this manual page, send it to perfmon2-devel@lists.sourceforge.net. This page was obtained from the project's upstream Git repository ⟨git://git.code.sf.net/p/perfmon2/libpfm4 perfmon2-libpfm4⟩ on 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2025-06-29.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.org November, 2013LIBPFM(3)HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |