7 files changed, 110 insertions, 0 deletions

diff --git a/Documentation/ABI/testing/sysfs-devices-power_resources_D0 b/Documentation/ABI/testing/sysfs-devices-power_resources_D0
new file mode 100644
index 000000000000..73b77a6be196
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-power_resources_D0
@@ -0,0 +1,13 @@
+What:           /sys/devices/.../power_resources_D0/
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../power_resources_D0/ directory is only
+                present for device objects representing ACPI device nodes that
+                use ACPI power resources for power management.
+
+                If present, it contains symbolic links to device directories
+                representing ACPI power resources that need to be turned on for
+                the given device node to be in ACPI power state D0.  The names
+                of the links are the same as the names of the directories they
+                point to.
diff --git a/Documentation/ABI/testing/sysfs-devices-power_resources_D1 b/Documentation/ABI/testing/sysfs-devices-power_resources_D1
new file mode 100644
index 000000000000..30c20703fb8c
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-power_resources_D1
@@ -0,0 +1,14 @@
+What:           /sys/devices/.../power_resources_D1/
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../power_resources_D1/ directory is only
+                present for device objects representing ACPI device nodes that
+                use ACPI power resources for power management and support ACPI
+                power state D1.
+
+                If present, it contains symbolic links to device directories
+                representing ACPI power resources that need to be turned on for
+                the given device node to be in ACPI power state D1.  The names
+                of the links are the same as the names of the directories they
+                point to.
diff --git a/Documentation/ABI/testing/sysfs-devices-power_resources_D2 b/Documentation/ABI/testing/sysfs-devices-power_resources_D2
new file mode 100644
index 000000000000..fd9d84b421e1
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-power_resources_D2
@@ -0,0 +1,14 @@
+What:           /sys/devices/.../power_resources_D2/
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../power_resources_D2/ directory is only
+                present for device objects representing ACPI device nodes that
+                use ACPI power resources for power management and support ACPI
+                power state D2.
+
+                If present, it contains symbolic links to device directories
+                representing ACPI power resources that need to be turned on for
+                the given device node to be in ACPI power state D2.  The names
+                of the links are the same as the names of the directories they
+                point to.
diff --git a/Documentation/ABI/testing/sysfs-devices-power_resources_D3hot b/Documentation/ABI/testing/sysfs-devices-power_resources_D3hot
new file mode 100644
index 000000000000..3df32c20addf
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-power_resources_D3hot
@@ -0,0 +1,14 @@
+What:           /sys/devices/.../power_resources_D3hot/
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../power_resources_D3hot/ directory is only
+                present for device objects representing ACPI device nodes that
+                use ACPI power resources for power management and support ACPI
+                power state D3hot.
+
+                If present, it contains symbolic links to device directories
+                representing ACPI power resources that need to be turned on for
+                the given device node to be in ACPI power state D3hot.  The
+                names of the links are the same as the names of the directories
+                they point to.
diff --git a/Documentation/ABI/testing/sysfs-devices-power_state b/Documentation/ABI/testing/sysfs-devices-power_state
new file mode 100644
index 000000000000..7ad9546748f0
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-power_state
@@ -0,0 +1,20 @@
+What:           /sys/devices/.../power_state
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../power_state attribute is only present for
+                device objects representing ACPI device nodes that provide power
+                management methods.
+
+                If present, it contains a string representing the current ACPI
+                power state of the given device node.  Its possible values,
+                "D0", "D1", "D2", "D3hot", and "D3cold", reflect the power state
+                names defined by the ACPI specification (ACPI 4 and above).
+
+                If the device node uses shared ACPI power resources, this state
+                determines a list of power resources required not to be turned
+                off.  However, some power resources needed by the device node in
+                higher-power (lower-number) states may also be ON because of
+                some other devices using them at the moment.
+
+                This attribute is read-only.
diff --git a/Documentation/ABI/testing/sysfs-devices-real_power_state b/Documentation/ABI/testing/sysfs-devices-real_power_state
new file mode 100644
index 000000000000..8b3527c82a7d
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-real_power_state
@@ -0,0 +1,23 @@
+What:           /sys/devices/.../real_power_state
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../real_power_state attribute is only present
+                for device objects representing ACPI device nodes that provide
+                power management methods and use ACPI power resources for power
+                management.
+
+                If present, it contains a string representing the real ACPI
+                power state of the given device node as returned by the _PSC
+                control method or inferred from the configuration of power
+                resources.  Its possible values, "D0", "D1", "D2", "D3hot", and
+                "D3cold", reflect the power state names defined by the ACPI
+                specification (ACPI 4 and above).
+
+                In some situations the value of this attribute may be different
+                from the value of the /sys/devices/.../power_state attribute for
+                the same device object.  If that happens, some shared power
+                resources used by the device node are only ON because of some
+                other devices using them at the moment.
+
+                This attribute is read-only.
diff --git a/Documentation/ABI/testing/sysfs-devices-resource_in_use b/Documentation/ABI/testing/sysfs-devices-resource_in_use
new file mode 100644
index 000000000000..b4a3bc5922a3
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-resource_in_use
@@ -0,0 +1,12 @@
+What:           /sys/devices/.../resource_in_use
+Date:           January 2013
+Contact:        Rafael J. Wysocki <rafael.j.wysocki@intel.com>
+Description:
+                The /sys/devices/.../resource_in_use attribute is only present
+                for device objects representing ACPI power resources.
+
+                If present, it contains a number (0 or 1) representing the
+                current status of the given power resource (0 means that the
+                resource is not in use and therefore it has been turned off).
+
+                This attribute is read-only.