powercap-set - manage power capping devices with the Linux power capping framework

Authors

       Connor Imes <connor.k.imes@gmail.com>

Bugs

       Report bugs upstream at <https://github.com/powercap/powercap>

Description

       Sets configurations for a powercap control type.

       The control type NAME must not be empty or contain a '.' or '/'.

Examples

powercap-setintel-rapl-z0-e1
              Enable zone 0 for the intel-rapl control type.

       powercap-setintel-rapl-z0:1-e1
              Enable zone 0, subzone 1 for the intel-rapl control type.

       powercap-setintel-rapl-z0-c1-l25000000
              Set a power cap of 25 Watts (25000000 uW) on zone 0, constraint 1 for the intel-rapl control type.

       powercap-setintel-rapl-z1:0-c0-l15000000-s976
              Set a power cap of 15 Watts (15000000 uW) and time window of 976 microseconds on zone  1,  subzone
              0, constraint 0 for the intel-rapl control type.

Files

/sys/devices/virtual/powercap/*/sys/class/powercap/*

Name

       powercap-set - manage power capping devices with the Linux power capping framework

Options

-h,--help
              Prints the help screen

       -p,--control-type=NAME
              Deprecated, provide NAME as the first positional argument instead.

       -z,--zone=ZONE(S)
              The  zone/subzone  numbers  in  the  control type's powercap tree.  Separate zones/subzones with a
              colon.  E.g., for zone 0, subzone 2:
              -z0:2-c,--constraint=CONSTRAINT
              The constraint number (none by default)

       -E,--enabled=1|0
              Enable/disable a control type

       The following zone-level arguments may be used together and require -z/--zone:

       -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 -z/--zone and -c/--constraint:

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

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

Remarks

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

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

       The kernel may round power limits and time windows to discrete values supported by the hardware, e.g., 28
       seconds might round to 27983872 microseconds.

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