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

# [NAME](#NAME)

libpfm\_intel\_rapl - support for Intel RAPL PMU

# [SYNOPSIS](#SYNOPSIS)

```
#include <perfmon/pfmlib.h>

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

```

# [DESCRIPTION](#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**](#RAPL_ENERGY_CORES)

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

[**RAPL\_ENERGYC\_PKG**](#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**](#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](#MODIFIERS)

The PMU does not support any modifiers.

# [AUTHORS](#AUTHORS)

```
Stephane Eranian <eranian@gmail.com>
```

November, 2013

---

Document: libpfm_intel_rapl(3) from libpfm 4.14.1-r0 (Chainguard OS)
Source: https://git.code.sf.net/p/perfmon2/libpfm4