android_kernel_samsung_msm8226/Documentation/power
Rafael J. Wysocki cf579dfb82 PM / Sleep: Introduce "late suspend" and "early resume" of devices
The current device suspend/resume phases during system-wide power
transitions appear to be insufficient for some platforms that want
to use the same callback routines for saving device states and
related operations during runtime suspend/resume as well as during
system suspend/resume.  In principle, they could point their
.suspend_noirq() and .resume_noirq() to the same callback routines
as their .runtime_suspend() and .runtime_resume(), respectively,
but at least some of them require device interrupts to be enabled
while the code in those routines is running.

It also makes sense to have device suspend-resume callbacks that will
be executed with runtime PM disabled and with device interrupts
enabled in case someone needs to run some special code in that
context during system-wide power transitions.

Apart from this, .suspend_noirq() and .resume_noirq() were introduced
as a workaround for drivers using shared interrupts and failing to
prevent their interrupt handlers from accessing suspended hardware.
It appears to be better not to use them for other porposes, or we may
have to deal with some serious confusion (which seems to be happening
already).

For the above reasons, introduce new device suspend/resume phases,
"late suspend" and "early resume" (and analogously for hibernation)
whose callback will be executed with runtime PM disabled and with
device interrupts enabled and whose callback pointers generally may
point to runtime suspend/resume routines.

Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl>
Reviewed-by: Mark Brown <broonie@opensource.wolfsonmicro.com>
Reviewed-by: Kevin Hilman <khilman@ti.com>
2012-01-29 20:38:29 +01:00
..
regulator regulator: Fix regulator_register() API signature in Documentation 2011-12-05 16:23:51 +00:00
00-INDEX PM / Documentation: Update docs about suspend and CPU hotplug 2011-10-22 00:22:28 +02:00
apm-acpi.txt
basic-pm-debugging.txt PM / Documentation: Fix spelling mistake in basic-pm-debugging.txt 2012-01-19 23:22:38 +01:00
charger-manager.txt power_supply: Charger-Manager: Add properties for power-supply-class 2012-01-04 08:08:45 +04:00
devices.txt PM / Sleep: Introduce "late suspend" and "early resume" of devices 2012-01-29 20:38:29 +01:00
drivers-testing.txt
freezing-of-tasks.txt PM / Documentation: Fix minor issue in freezing_of_tasks.txt 2012-01-19 23:22:49 +01:00
interface.txt
notifiers.txt
opp.txt
pci.txt
pm_qos_interface.txt PM / QoS: Update Documentation for the pm_qos and dev_pm_qos frameworks 2011-10-04 21:54:45 +02:00
power_supply_class.txt
runtime_pm.txt PM: Run the driver callback directly if the subsystem one is not there 2011-12-21 22:01:05 +01:00
s2ram.txt
states.txt
suspend-and-cpuhotplug.txt PM / Documentation: Update docs about suspend and CPU hotplug 2011-10-22 00:22:28 +02:00
swsusp-and-swap-files.txt
swsusp-dmcrypt.txt
swsusp.txt
tricks.txt
userland-swsusp.txt
video.txt
video_extension.txt