libpfm_intel_rapl(3) — Linux manual page

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

NAME

       libpfm_intel_rapl - support for Intel RAPL PMU

SYNOPSIS

       #include <perfmon/pfmlib.h>

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

DESCRIPTION

       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

       The PMU does not support any modifiers.

AUTHORS

       Stephane Eranian <eranian@gmail.com>

COLOPHON

       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
       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
       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 man-pages@man7.org

                             November, 2013                    LIBPFM(3)