rapl-set1

Synposis

rapl-set [OPTION]...

Overview

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

Sets Intel Running Average Power Limit (RAPL) configurations.

Note that the -p and -z options are different from powercap-set(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

-p, --zone=ZONE

The zone number (0 by default)

-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)

The following zone-level arguments may be used together (-z/--subzone is optional):

-j, --z-energy

Reset zone energy counter

-e, --z-enabled=1|0

Enable/disable a zone

The following constraint-level arguments may be used together and require -c/--constraint (-z/--subzone is optional):

-l, --c-power-limit=UW

Set constraint power limit

-s, --c-time-window=US

Set constraint time window

Examples

Note that -p/--zone=0 is used by default, allowing for simpler commands on single-socket systems.

rapl-set -e 1

Enable zone 0 (implicitly), which is usually named package-0.

rapl-set -p 0 -e 1

Enable zone 0 (explicitly).

rapl-set -p 0 -z 1 -e 1

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

rapl-set -p 0 -c 1 -l 25000000

Set a power cap of 25 Watts (25000000 uW) on zone 0, constraint 1, which is usually the short_term constraint for package-0.

rapl-set -p 1 -z 0 -c 0 -l 15000000 -s 976

Set a power cap of 15 Watts (15000000 uW) and time window of 976 microseconds on zone 1, subzone 0, constraint 0, which is usually the long_term (and only) constraint for the core subzone of package-1 (a multi-socket system).

Remarks

Administrative (root) privileges are usually needed to use rapl-set.

Setting constraint power cap and/or time limit values does not enable or disable a zone/subzone - the -e/--z-enabled flag must be set explicitly.

Power units: microwatts (uW)
Time units: microseconds (us)

Files

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