NAME

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

SYNPOSIS

       powercap-set NAME [OPTION]...

DESCRIPTION

       Sets configurations for a powercap control type.

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

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:
              -z 0: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

EXAMPLES

       These examples use Intel RAPL, for which the control type is intel-rapl.

       powercap-set intel-rapl -z 0 -e 1
              Enable zone 0.

       powercap-set intel-rapl -z 0:1 -e 1
              Enable zone 0, subzone 1.

       powercap-set intel-rapl -z 0 -c 1 -l 25000000
              Set a power cap of 25 Watts (25000000 uW) on zone 0, constraint 1.

       powercap-set intel-rapl -z 1: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.

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)

BUGS

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

FILES

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

AUTHORS

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

SEE ALSO

       powercap-info(1)