What:  /sys/class/powercap/
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  The powercap/ class sub directory belongs to the power cap
  subsystem. Refer to
  Documentation/power/powercap/powercap.rst for details.

What:  /sys/class/powercap/<control type>
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  A <control type> is a unique name under /sys/class/powercap.
  Here <control type> determines how the power is going to be
  controlled. A <control type> can contain multiple power zones.

What:  /sys/class/powercap/<control type>/enabled
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  This allows to enable/disable power capping for a "control type".
  This status affects every power zone using this "control_type.

What:  /sys/class/powercap/<control type>/<power zone>
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  A power zone is a single or a collection of devices, which can
  be independently monitored and controlled. A power zone sysfs
  entry is qualified with the name of the <control type>.
  E.g. intel-rapl:0:1:1.

What:  /sys/class/powercap/<control type>/<power zone>/<child power zone>
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Power zones may be organized in a hierarchy in which child
  power zones provide monitoring and control for a subset of
  devices under the parent. For example, if there is a parent
  power zone for a whole CPU package, each CPU core in it can
  be a child power zone.

What:  /sys/class/powercap/.../<power zone>/name
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Specifies the name of this power zone.

What:  /sys/class/powercap/.../<power zone>/energy_uj
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Current energy counter in micro-joules. Write "0" to reset.
  If the counter can not be reset, then this attribute is
  read-only.

What:  /sys/class/powercap/.../<power zone>/max_energy_range_uj
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Range of the above energy counter in micro-joules.


What:  /sys/class/powercap/.../<power zone>/power_uw
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Current power in micro-watts.

What:  /sys/class/powercap/.../<power zone>/max_power_range_uw
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Range of the above power value in micro-watts.

What:  /sys/class/powercap/.../<power zone>/constraint_X_name
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Each power zone can define one or more constraints. Each
  constraint can have an optional name. Here "X" can have values
  from 0 to max integer.

What:  /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Power limit in micro-watts should be applicable for
  the time window specified by "constraint_X_time_window_us".
  Here "X" can have values from 0 to max integer.

What:  /sys/class/powercap/.../<power zone>/constraint_X_time_window_us
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Time window in micro seconds. This is used along with
  constraint_X_power_limit_uw to define a power constraint.
  Here "X" can have values from 0 to max integer.


What:  /sys/class/powercap/<control type>/.../constraint_X_max_power_uw
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Maximum allowed power in micro watts for this constraint.
  Here "X" can have values from 0 to max integer.

What:  /sys/class/powercap/<control type>/.../constraint_X_min_power_uw
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Minimum allowed power in micro watts for this constraint.
  Here "X" can have values from 0 to max integer.

What:  /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Maximum allowed time window in micro seconds for this
  constraint. Here "X" can have values from 0 to max integer.

What:  /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  Minimum allowed time window in micro seconds for this
  constraint. Here "X" can have values from 0 to max integer.

What:  /sys/class/powercap/.../<power zone>/enabled
Date:  September 2013
KernelVersion: 3.13
Contact: linux-pm@vger.kernel.org
Description:
  This allows to enable/disable power capping at power zone level.
  This applies to current power zone and its children.