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