---
name: "libpfm_intel_rapl"
section: "3"
platform: "linux"
package: "libpfm"
version: "4.14.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libpfm_intel_rapl"
---

# libpfm\_intel\_rapl(3)

support for Intel RAPL PMU

## 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>
```