mirror of
https://github.com/brain-hackers/linux-brain.git
synced 2024-06-09 23:36:23 +09:00
151f4e2bdc
Convert the PM documents to ReST, in order to allow them to build with Sphinx. The conversion is actually: - add blank lines and indentation in order to identify paragraphs; - fix tables markups; - add some lists markups; - mark literal blocks; - adjust title markups. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Signed-off-by: Bjorn Helgaas <bhelgaas@google.com> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Srivatsa S. Bhat (VMware) <srivatsa@csail.mit.edu>
153 lines
4.9 KiB
Plaintext
153 lines
4.9 KiB
Plaintext
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.
|