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

              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
       2018-02-02.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-01-25.)  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)