libpfm_intel_rapl(3) — Linux manual page


LIBPFM(3)               Linux Programmer's Manual              LIBPFM(3)

NAME         top

       libpfm_intel_rapl - support for Intel RAPL PMU

SYNOPSIS         top

       #include <perfmon/pfmlib.h>

       PMU name: rapl
       PMU desc: Intel RAPL (Intel SandyBridge, IvyBridge, Haswell)

DESCRIPTION         top

       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:

              On all processors, the event reports the number of Joules
              consumed by all cores.
               On all processors,

              On all processors, th event reports the number of Joules
              consumed by all the cores and Last Level cache (L3).

              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.

MODIFIERS         top

       The PMU does not support any modifiers.

AUTHORS         top

       Stephane Eranian <>

COLOPHON         top

       This page is part of the perfmon2 (a performance monitoring
       library) project.  Information about the project can be found at
       ⟨⟩.  If you have a bug report for
       this manual page, send it to  This page was obtained
       from the project's upstream Git repository
       ⟨git:// perfmon2-libpfm4⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-09-28.)  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 is not part of the original
       manual page), send a mail to

                             November, 2013                    LIBPFM(3)