^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/class/powercap/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) The powercap/ class sub directory belongs to the power cap
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) subsystem. Refer to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Documentation/power/powercap/powercap.rst for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) What: /sys/class/powercap/<control type>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) A <control type> is a unique name under /sys/class/powercap.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Here <control type> determines how the power is going to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) controlled. A <control type> can contain multiple power zones.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) What: /sys/class/powercap/<control type>/enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) This allows to enable/disable power capping for a "control type".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) This status affects every power zone using this "control_type.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) What: /sys/class/powercap/<control type>/<power zone>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) A power zone is a single or a collection of devices, which can
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) be independently monitored and controlled. A power zone sysfs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) entry is qualified with the name of the <control type>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) E.g. intel-rapl:0:1:1.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) What: /sys/class/powercap/<control type>/<power zone>/<child power zone>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Power zones may be organized in a hierarchy in which child
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) power zones provide monitoring and control for a subset of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) devices under the parent. For example, if there is a parent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) power zone for a whole CPU package, each CPU core in it can
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) be a child power zone.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) What: /sys/class/powercap/.../<power zone>/name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) Specifies the name of this power zone.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) What: /sys/class/powercap/.../<power zone>/energy_uj
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) Current energy counter in micro-joules. Write "0" to reset.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) If the counter can not be reset, then this attribute is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) read-only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) What: /sys/class/powercap/.../<power zone>/max_energy_range_uj
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Range of the above energy counter in micro-joules.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) What: /sys/class/powercap/.../<power zone>/power_uw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Current power in micro-watts.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) What: /sys/class/powercap/.../<power zone>/max_power_range_uw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) Range of the above power value in micro-watts.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) What: /sys/class/powercap/.../<power zone>/constraint_X_name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) Each power zone can define one or more constraints. Each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) constraint can have an optional name. Here "X" can have values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) What: /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) Power limit in micro-watts should be applicable for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) the time window specified by "constraint_X_time_window_us".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) What: /sys/class/powercap/.../<power zone>/constraint_X_time_window_us
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) Time window in micro seconds. This is used along with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) constraint_X_power_limit_uw to define a power constraint.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) What: /sys/class/powercap/<control type>/.../constraint_X_max_power_uw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) Maximum allowed power in micro watts for this constraint.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) What: /sys/class/powercap/<control type>/.../constraint_X_min_power_uw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) Minimum allowed power in micro watts for this constraint.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) What: /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) Maximum allowed time window in micro seconds for this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) constraint. Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) What: /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) Minimum allowed time window in micro seconds for this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) constraint. Here "X" can have values from 0 to max integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) What: /sys/class/powercap/.../<power zone>/enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Date: September 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) Contact: linux-pm@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) This allows to enable/disable power capping at power zone level.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) This applies to current power zone and its children.