rapl-info1

Synposis

rapl-info [OPTION]...

Overview

This utility is deprecated, use powercap-info(1) instead.

Prints out Intel Running Average Power Limit (RAPL) configurations.

Note that the -p and -z options are different from powercap-info(1).

This software requires an Intel processor (Sandy Bridge or newer), Linux kernel 3.13 or newer compiled with CONFIG_POWERCAP and CONFIG_INTEL_RAPL enabled, and the intel_rapl kernel module to be loaded.

Options

-h, --help

Prints out the help screen

-v, --verbose

Print errors when files are not available

-p, --zone=ZONE

The zone number (none by default; 0 by default if using -z/--subzone and/or -c/--constraint). Ending with a colon prevents output for subzones. E.g., for zone 0, but not subzones:
-p 0:

-p, --package=PACKAGE

Deprecated, use --zone instead

-z, --subzone=SUBZONE

The subzone number (none by default)

-c, --constraint=CONSTRAINT

The constraint number (none by default)

All remaining options below are mutually exclusive:

-n, --nzones

Print the number of zones found, or the number of subzones found if -p/--zone is set

The following are zone-level arguments (-z/--subzone is optional):

-j, --z-energy

Print zone energy counter

-J, --z-max-energy-range

Print zone maximum energy counter range

-w, --z-power

Print zone current power

-W, --z-max-power-range

Print zone maximum current power range

-e, --z-enabled

Print zone enable/disabled status

-x, --z-name

Print zone name

The following are constraint-level arguments and require -c/--constraint (-z/--subzone is optional):

-l, --c-power-limit

Print constraint power limit

-s, --c-time-window

Print constraint time window

-U, --c-max-power

Print constraint maximum allowed power

-u, --c-min-power

Print constraint minimum allowed power

-T, --c-max-time-window

Print constraint maximum allowed time window

-t, --c-min-time-window

Print constraint minimum allowed time window

-y, --c-name

Print constraint name

Examples

Note that -p/--zone=0 is used by default when also specifying -z/--subzone and/or -c/--constraint, allowing for simpler commands on single-socket systems.

rapl-info

Print all RAPL zones.

rapl-info -p 0

Print only zone 0, which is usually named package-0.

rapl-info -p 0 -z 1

Print zone 0, subzone 1, which is usually the uncore or dram subzone of package-0, depending on the system.

rapl-info -p 0 -c 1

Print zone 0, constraint 1, which is usually the short_term constraint for package-0.

rapl-info -p 0 -j

Print the energy counter for zone 0, which is usually named package-0.

rapl-info -p 1 -z 0 -c 0 -l

Print the power limit for zone 1, subzone 0, constraint 0, which is usually the long_term constraint for the core subzone of package-1 (a multi-socket system).

Remarks

Some fields are optional and will only be printed if they are available unless -v/--verbose is set.
If no zone/constraint-specific outputs are requested, all available zones and constraints will be shown.

Energy units: microjoules (uJ)
Power units: microwatts (uW)
Time units: microseconds (us)

Files

/sys/devices/virtual/powercap/intel-rapl/*
/sys/class/powercap/intel-rapl/*