0001 What: /sys/class/powercap/
0002 Date: September 2013
0003 KernelVersion: 3.13
0004 Contact: linux-pm@vger.kernel.org
0005 Description:
0006 The powercap/ class sub directory belongs to the power cap
0007 subsystem. Refer to
0008 Documentation/power/powercap/powercap.rst for details.
0009
0010 What: /sys/class/powercap/<control type>
0011 Date: September 2013
0012 KernelVersion: 3.13
0013 Contact: linux-pm@vger.kernel.org
0014 Description:
0015 A <control type> is a unique name under /sys/class/powercap.
0016 Here <control type> determines how the power is going to be
0017 controlled. A <control type> can contain multiple power zones.
0018
0019 What: /sys/class/powercap/<control type>/enabled
0020 Date: September 2013
0021 KernelVersion: 3.13
0022 Contact: linux-pm@vger.kernel.org
0023 Description:
0024 This allows to enable/disable power capping for a "control type".
0025 This status affects every power zone using this "control_type.
0026
0027 What: /sys/class/powercap/<control type>/<power zone>
0028 Date: September 2013
0029 KernelVersion: 3.13
0030 Contact: linux-pm@vger.kernel.org
0031 Description:
0032 A power zone is a single or a collection of devices, which can
0033 be independently monitored and controlled. A power zone sysfs
0034 entry is qualified with the name of the <control type>.
0035 E.g. intel-rapl:0:1:1.
0036
0037 What: /sys/class/powercap/<control type>/<power zone>/<child power zone>
0038 Date: September 2013
0039 KernelVersion: 3.13
0040 Contact: linux-pm@vger.kernel.org
0041 Description:
0042 Power zones may be organized in a hierarchy in which child
0043 power zones provide monitoring and control for a subset of
0044 devices under the parent. For example, if there is a parent
0045 power zone for a whole CPU package, each CPU core in it can
0046 be a child power zone.
0047
0048 What: /sys/class/powercap/.../<power zone>/name
0049 Date: September 2013
0050 KernelVersion: 3.13
0051 Contact: linux-pm@vger.kernel.org
0052 Description:
0053 Specifies the name of this power zone.
0054
0055 What: /sys/class/powercap/.../<power zone>/energy_uj
0056 Date: September 2013
0057 KernelVersion: 3.13
0058 Contact: linux-pm@vger.kernel.org
0059 Description:
0060 Current energy counter in micro-joules. Write "0" to reset.
0061 If the counter can not be reset, then this attribute is
0062 read-only.
0063
0064 What: /sys/class/powercap/.../<power zone>/max_energy_range_uj
0065 Date: September 2013
0066 KernelVersion: 3.13
0067 Contact: linux-pm@vger.kernel.org
0068 Description:
0069 Range of the above energy counter in micro-joules.
0070
0071
0072 What: /sys/class/powercap/.../<power zone>/power_uw
0073 Date: September 2013
0074 KernelVersion: 3.13
0075 Contact: linux-pm@vger.kernel.org
0076 Description:
0077 Current power in micro-watts.
0078
0079 What: /sys/class/powercap/.../<power zone>/max_power_range_uw
0080 Date: September 2013
0081 KernelVersion: 3.13
0082 Contact: linux-pm@vger.kernel.org
0083 Description:
0084 Range of the above power value in micro-watts.
0085
0086 What: /sys/class/powercap/.../<power zone>/constraint_X_name
0087 Date: September 2013
0088 KernelVersion: 3.13
0089 Contact: linux-pm@vger.kernel.org
0090 Description:
0091 Each power zone can define one or more constraints. Each
0092 constraint can have an optional name. Here "X" can have values
0093 from 0 to max integer.
0094
0095 What: /sys/class/powercap/.../<power zone>/constraint_X_power_limit_uw
0096 Date: September 2013
0097 KernelVersion: 3.13
0098 Contact: linux-pm@vger.kernel.org
0099 Description:
0100 Power limit in micro-watts should be applicable for
0101 the time window specified by "constraint_X_time_window_us".
0102 Here "X" can have values from 0 to max integer.
0103
0104 What: /sys/class/powercap/.../<power zone>/constraint_X_time_window_us
0105 Date: September 2013
0106 KernelVersion: 3.13
0107 Contact: linux-pm@vger.kernel.org
0108 Description:
0109 Time window in micro seconds. This is used along with
0110 constraint_X_power_limit_uw to define a power constraint.
0111 Here "X" can have values from 0 to max integer.
0112
0113
0114 What: /sys/class/powercap/<control type>/.../constraint_X_max_power_uw
0115 Date: September 2013
0116 KernelVersion: 3.13
0117 Contact: linux-pm@vger.kernel.org
0118 Description:
0119 Maximum allowed power in micro watts for this constraint.
0120 Here "X" can have values from 0 to max integer.
0121
0122 What: /sys/class/powercap/<control type>/.../constraint_X_min_power_uw
0123 Date: September 2013
0124 KernelVersion: 3.13
0125 Contact: linux-pm@vger.kernel.org
0126 Description:
0127 Minimum allowed power in micro watts for this constraint.
0128 Here "X" can have values from 0 to max integer.
0129
0130 What: /sys/class/powercap/.../<power zone>/constraint_X_max_time_window_us
0131 Date: September 2013
0132 KernelVersion: 3.13
0133 Contact: linux-pm@vger.kernel.org
0134 Description:
0135 Maximum allowed time window in micro seconds for this
0136 constraint. Here "X" can have values from 0 to max integer.
0137
0138 What: /sys/class/powercap/.../<power zone>/constraint_X_min_time_window_us
0139 Date: September 2013
0140 KernelVersion: 3.13
0141 Contact: linux-pm@vger.kernel.org
0142 Description:
0143 Minimum allowed time window in micro seconds for this
0144 constraint. Here "X" can have values from 0 to max integer.
0145
0146 What: /sys/class/powercap/.../<power zone>/enabled
0147 Date: September 2013
0148 KernelVersion: 3.13
0149 Contact: linux-pm@vger.kernel.org
0150 Description:
0151 This allows to enable/disable power capping at power zone level.
0152 This applies to current power zone and its children.
