libpfm_intel_rapl(3) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| MODIFIERS \| AUTHORS \| COLOPHON

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:

       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.

MODIFIERS top

       The PMU does not support any modifiers.

AUTHORS top

       Stephane Eranian <[email protected]>

COLOPHON top

       This page is part of the perfmon2 (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
       [email protected].  This page was obtained
       from the project's upstream Git repository
       ⟨git://git.code.sf.net/p/perfmon2/libpfm4 perfmon2-libpfm4⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-04-24.)  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 [email protected]

                             November, 2013                    LIBPFM(3)