mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-26 06:04:14 +08:00
fe0c935a6c
This patch series cleans up some misconceptions about pm_ops. Some users of the pm_ops structure attempt to use it to stop the user from entering suspend to disk, this, however, is not possible since the user can always use "shutdown" in /sys/power/disk and then the pm_ops are never invoked. Also, platforms that don't support suspend to disk simply should not allow configuring SOFTWARE_SUSPEND (read the help text on it, it only selects suspend to disk and nothing else, all the other stuff depends on PM). The pm_ops structure is actually intended to provide a way to enter platform-defined sleep states (currently supported states are "standby" and "mem" (suspend to ram)) and additionally (if SOFTWARE_SUSPEND is configured) allows a platform to support a platform specific way to enter low-power mode once everything has been saved to disk. This is currently only used by ACPI (S4). This patch: The pm_ops.pm_disk_mode is used in totally bogus ways since nobody really seems to understand what it actually does. This patch clarifies the pm_disk_mode description. It also removes all the arm and sh users that think they can veto suspend to disk via pm_ops; not so since the user can always do echo shutdown > /sys/power/disk, they need to find a better way involving Kconfig or such. ACPI is the only user left with a non-zero pm_disk_mode. The patch also sets the default mode to shutdown again, but when a new pm_ops is registered its pm_disk_mode is selected as default, that way the default stays for ACPI where it is apparently required. Signed-off-by: Johannes Berg <johannes@sipsolutions.net> Cc: David Brownell <david-b@pacbell.net> Acked-by: Pavel Machek <pavel@ucw.cz> Cc: <linux-pm@lists.linux-foundation.org> Cc: Len Brown <lenb@kernel.org> Acked-by: Russell King <rmk@arm.linux.org.uk> Cc: Greg KH <greg@kroah.com> Cc: "Rafael J. Wysocki" <rjw@sisk.pl> Acked-by: Paul Mundt <lethal@linux-sh.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
484 lines
9.6 KiB
C
484 lines
9.6 KiB
C
/*
|
|
* kernel/power/disk.c - Suspend-to-disk support.
|
|
*
|
|
* Copyright (c) 2003 Patrick Mochel
|
|
* Copyright (c) 2003 Open Source Development Lab
|
|
* Copyright (c) 2004 Pavel Machek <pavel@suse.cz>
|
|
*
|
|
* This file is released under the GPLv2.
|
|
*
|
|
*/
|
|
|
|
#include <linux/suspend.h>
|
|
#include <linux/syscalls.h>
|
|
#include <linux/reboot.h>
|
|
#include <linux/string.h>
|
|
#include <linux/device.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/fs.h>
|
|
#include <linux/mount.h>
|
|
#include <linux/pm.h>
|
|
#include <linux/console.h>
|
|
#include <linux/cpu.h>
|
|
#include <linux/freezer.h>
|
|
|
|
#include "power.h"
|
|
|
|
|
|
static int noresume = 0;
|
|
char resume_file[256] = CONFIG_PM_STD_PARTITION;
|
|
dev_t swsusp_resume_device;
|
|
sector_t swsusp_resume_block;
|
|
|
|
/**
|
|
* platform_prepare - prepare the machine for hibernation using the
|
|
* platform driver if so configured and return an error code if it fails
|
|
*/
|
|
|
|
static inline int platform_prepare(void)
|
|
{
|
|
int error = 0;
|
|
|
|
switch (pm_disk_mode) {
|
|
case PM_DISK_TEST:
|
|
case PM_DISK_TESTPROC:
|
|
case PM_DISK_SHUTDOWN:
|
|
case PM_DISK_REBOOT:
|
|
break;
|
|
default:
|
|
if (pm_ops && pm_ops->prepare)
|
|
error = pm_ops->prepare(PM_SUSPEND_DISK);
|
|
}
|
|
return error;
|
|
}
|
|
|
|
/**
|
|
* power_down - Shut machine down for hibernate.
|
|
*
|
|
* Use the platform driver, if configured so; otherwise try
|
|
* to power off or reboot.
|
|
*/
|
|
|
|
static void power_down(void)
|
|
{
|
|
switch (pm_disk_mode) {
|
|
case PM_DISK_TEST:
|
|
case PM_DISK_TESTPROC:
|
|
break;
|
|
case PM_DISK_SHUTDOWN:
|
|
kernel_power_off();
|
|
break;
|
|
case PM_DISK_REBOOT:
|
|
kernel_restart(NULL);
|
|
break;
|
|
default:
|
|
if (pm_ops && pm_ops->enter) {
|
|
kernel_shutdown_prepare(SYSTEM_SUSPEND_DISK);
|
|
pm_ops->enter(PM_SUSPEND_DISK);
|
|
break;
|
|
}
|
|
}
|
|
kernel_halt();
|
|
/*
|
|
* Valid image is on the disk, if we continue we risk serious data
|
|
* corruption after resume.
|
|
*/
|
|
printk(KERN_CRIT "Please power me down manually\n");
|
|
while(1);
|
|
}
|
|
|
|
static inline void platform_finish(void)
|
|
{
|
|
switch (pm_disk_mode) {
|
|
case PM_DISK_TEST:
|
|
case PM_DISK_TESTPROC:
|
|
case PM_DISK_SHUTDOWN:
|
|
case PM_DISK_REBOOT:
|
|
break;
|
|
default:
|
|
if (pm_ops && pm_ops->finish)
|
|
pm_ops->finish(PM_SUSPEND_DISK);
|
|
}
|
|
}
|
|
|
|
static void unprepare_processes(void)
|
|
{
|
|
thaw_processes();
|
|
pm_restore_console();
|
|
}
|
|
|
|
static int prepare_processes(void)
|
|
{
|
|
int error = 0;
|
|
|
|
pm_prepare_console();
|
|
if (freeze_processes()) {
|
|
error = -EBUSY;
|
|
unprepare_processes();
|
|
}
|
|
return error;
|
|
}
|
|
|
|
/**
|
|
* pm_suspend_disk - The granpappy of hibernation power management.
|
|
*
|
|
* If we're going through the firmware, then get it over with quickly.
|
|
*
|
|
* If not, then call swsusp to do its thing, then figure out how
|
|
* to power down the system.
|
|
*/
|
|
|
|
int pm_suspend_disk(void)
|
|
{
|
|
int error;
|
|
|
|
error = prepare_processes();
|
|
if (error)
|
|
return error;
|
|
|
|
if (pm_disk_mode == PM_DISK_TESTPROC) {
|
|
printk("swsusp debug: Waiting for 5 seconds.\n");
|
|
mdelay(5000);
|
|
goto Thaw;
|
|
}
|
|
/* Free memory before shutting down devices. */
|
|
error = swsusp_shrink_memory();
|
|
if (error)
|
|
goto Thaw;
|
|
|
|
error = platform_prepare();
|
|
if (error)
|
|
goto Thaw;
|
|
|
|
suspend_console();
|
|
error = device_suspend(PMSG_FREEZE);
|
|
if (error) {
|
|
printk(KERN_ERR "PM: Some devices failed to suspend\n");
|
|
goto Resume_devices;
|
|
}
|
|
error = disable_nonboot_cpus();
|
|
if (error)
|
|
goto Enable_cpus;
|
|
|
|
if (pm_disk_mode == PM_DISK_TEST) {
|
|
printk("swsusp debug: Waiting for 5 seconds.\n");
|
|
mdelay(5000);
|
|
goto Enable_cpus;
|
|
}
|
|
|
|
pr_debug("PM: snapshotting memory.\n");
|
|
in_suspend = 1;
|
|
error = swsusp_suspend();
|
|
if (error)
|
|
goto Enable_cpus;
|
|
|
|
if (in_suspend) {
|
|
enable_nonboot_cpus();
|
|
platform_finish();
|
|
device_resume();
|
|
resume_console();
|
|
pr_debug("PM: writing image.\n");
|
|
error = swsusp_write();
|
|
if (!error)
|
|
power_down();
|
|
else {
|
|
swsusp_free();
|
|
goto Thaw;
|
|
}
|
|
} else {
|
|
pr_debug("PM: Image restored successfully.\n");
|
|
}
|
|
|
|
swsusp_free();
|
|
Enable_cpus:
|
|
enable_nonboot_cpus();
|
|
Resume_devices:
|
|
platform_finish();
|
|
device_resume();
|
|
resume_console();
|
|
Thaw:
|
|
unprepare_processes();
|
|
return error;
|
|
}
|
|
|
|
|
|
/**
|
|
* software_resume - Resume from a saved image.
|
|
*
|
|
* Called as a late_initcall (so all devices are discovered and
|
|
* initialized), we call swsusp to see if we have a saved image or not.
|
|
* If so, we quiesce devices, the restore the saved image. We will
|
|
* return above (in pm_suspend_disk() ) if everything goes well.
|
|
* Otherwise, we fail gracefully and return to the normally
|
|
* scheduled program.
|
|
*
|
|
*/
|
|
|
|
static int software_resume(void)
|
|
{
|
|
int error;
|
|
|
|
mutex_lock(&pm_mutex);
|
|
if (!swsusp_resume_device) {
|
|
if (!strlen(resume_file)) {
|
|
mutex_unlock(&pm_mutex);
|
|
return -ENOENT;
|
|
}
|
|
swsusp_resume_device = name_to_dev_t(resume_file);
|
|
pr_debug("swsusp: Resume From Partition %s\n", resume_file);
|
|
} else {
|
|
pr_debug("swsusp: Resume From Partition %d:%d\n",
|
|
MAJOR(swsusp_resume_device), MINOR(swsusp_resume_device));
|
|
}
|
|
|
|
if (noresume) {
|
|
/**
|
|
* FIXME: If noresume is specified, we need to find the partition
|
|
* and reset it back to normal swap space.
|
|
*/
|
|
mutex_unlock(&pm_mutex);
|
|
return 0;
|
|
}
|
|
|
|
pr_debug("PM: Checking swsusp image.\n");
|
|
|
|
error = swsusp_check();
|
|
if (error)
|
|
goto Done;
|
|
|
|
pr_debug("PM: Preparing processes for restore.\n");
|
|
|
|
error = prepare_processes();
|
|
if (error) {
|
|
swsusp_close();
|
|
goto Done;
|
|
}
|
|
|
|
pr_debug("PM: Reading swsusp image.\n");
|
|
|
|
error = swsusp_read();
|
|
if (error) {
|
|
swsusp_free();
|
|
goto Thaw;
|
|
}
|
|
|
|
pr_debug("PM: Preparing devices for restore.\n");
|
|
|
|
suspend_console();
|
|
error = device_suspend(PMSG_PRETHAW);
|
|
if (error)
|
|
goto Free;
|
|
|
|
error = disable_nonboot_cpus();
|
|
if (!error)
|
|
swsusp_resume();
|
|
|
|
enable_nonboot_cpus();
|
|
Free:
|
|
swsusp_free();
|
|
device_resume();
|
|
resume_console();
|
|
Thaw:
|
|
printk(KERN_ERR "PM: Restore failed, recovering.\n");
|
|
unprepare_processes();
|
|
Done:
|
|
/* For success case, the suspend path will release the lock */
|
|
mutex_unlock(&pm_mutex);
|
|
pr_debug("PM: Resume from disk failed.\n");
|
|
return 0;
|
|
}
|
|
|
|
late_initcall(software_resume);
|
|
|
|
|
|
static const char * const pm_disk_modes[] = {
|
|
[PM_DISK_FIRMWARE] = "firmware",
|
|
[PM_DISK_PLATFORM] = "platform",
|
|
[PM_DISK_SHUTDOWN] = "shutdown",
|
|
[PM_DISK_REBOOT] = "reboot",
|
|
[PM_DISK_TEST] = "test",
|
|
[PM_DISK_TESTPROC] = "testproc",
|
|
};
|
|
|
|
/**
|
|
* disk - Control suspend-to-disk mode
|
|
*
|
|
* Suspend-to-disk can be handled in several ways. The greatest
|
|
* distinction is who writes memory to disk - the firmware or the OS.
|
|
* If the firmware does it, we assume that it also handles suspending
|
|
* the system.
|
|
* If the OS does it, then we have three options for putting the system
|
|
* to sleep - using the platform driver (e.g. ACPI or other PM registers),
|
|
* powering off the system or rebooting the system (for testing).
|
|
*
|
|
* The system will support either 'firmware' or 'platform', and that is
|
|
* known a priori (and encoded in pm_ops). But, the user may choose
|
|
* 'shutdown' or 'reboot' as alternatives.
|
|
*
|
|
* show() will display what the mode is currently set to.
|
|
* store() will accept one of
|
|
*
|
|
* 'firmware'
|
|
* 'platform'
|
|
* 'shutdown'
|
|
* 'reboot'
|
|
*
|
|
* It will only change to 'firmware' or 'platform' if the system
|
|
* supports it (as determined from pm_ops->pm_disk_mode).
|
|
*/
|
|
|
|
static ssize_t disk_show(struct subsystem * subsys, char * buf)
|
|
{
|
|
return sprintf(buf, "%s\n", pm_disk_modes[pm_disk_mode]);
|
|
}
|
|
|
|
|
|
static ssize_t disk_store(struct subsystem * s, const char * buf, size_t n)
|
|
{
|
|
int error = 0;
|
|
int i;
|
|
int len;
|
|
char *p;
|
|
suspend_disk_method_t mode = 0;
|
|
|
|
p = memchr(buf, '\n', n);
|
|
len = p ? p - buf : n;
|
|
|
|
mutex_lock(&pm_mutex);
|
|
for (i = PM_DISK_FIRMWARE; i < PM_DISK_MAX; i++) {
|
|
if (!strncmp(buf, pm_disk_modes[i], len)) {
|
|
mode = i;
|
|
break;
|
|
}
|
|
}
|
|
if (mode) {
|
|
switch (mode) {
|
|
case PM_DISK_SHUTDOWN:
|
|
case PM_DISK_REBOOT:
|
|
case PM_DISK_TEST:
|
|
case PM_DISK_TESTPROC:
|
|
pm_disk_mode = mode;
|
|
break;
|
|
default:
|
|
if (pm_ops && pm_ops->enter &&
|
|
(mode == pm_ops->pm_disk_mode))
|
|
pm_disk_mode = mode;
|
|
else
|
|
error = -EINVAL;
|
|
}
|
|
} else {
|
|
error = -EINVAL;
|
|
}
|
|
|
|
pr_debug("PM: suspend-to-disk mode set to '%s'\n",
|
|
pm_disk_modes[mode]);
|
|
mutex_unlock(&pm_mutex);
|
|
return error ? error : n;
|
|
}
|
|
|
|
power_attr(disk);
|
|
|
|
static ssize_t resume_show(struct subsystem * subsys, char *buf)
|
|
{
|
|
return sprintf(buf,"%d:%d\n", MAJOR(swsusp_resume_device),
|
|
MINOR(swsusp_resume_device));
|
|
}
|
|
|
|
static ssize_t resume_store(struct subsystem *subsys, const char *buf, size_t n)
|
|
{
|
|
unsigned int maj, min;
|
|
dev_t res;
|
|
int ret = -EINVAL;
|
|
|
|
if (sscanf(buf, "%u:%u", &maj, &min) != 2)
|
|
goto out;
|
|
|
|
res = MKDEV(maj,min);
|
|
if (maj != MAJOR(res) || min != MINOR(res))
|
|
goto out;
|
|
|
|
mutex_lock(&pm_mutex);
|
|
swsusp_resume_device = res;
|
|
mutex_unlock(&pm_mutex);
|
|
printk("Attempting manual resume\n");
|
|
noresume = 0;
|
|
software_resume();
|
|
ret = n;
|
|
out:
|
|
return ret;
|
|
}
|
|
|
|
power_attr(resume);
|
|
|
|
static ssize_t image_size_show(struct subsystem * subsys, char *buf)
|
|
{
|
|
return sprintf(buf, "%lu\n", image_size);
|
|
}
|
|
|
|
static ssize_t image_size_store(struct subsystem * subsys, const char * buf, size_t n)
|
|
{
|
|
unsigned long size;
|
|
|
|
if (sscanf(buf, "%lu", &size) == 1) {
|
|
image_size = size;
|
|
return n;
|
|
}
|
|
|
|
return -EINVAL;
|
|
}
|
|
|
|
power_attr(image_size);
|
|
|
|
static struct attribute * g[] = {
|
|
&disk_attr.attr,
|
|
&resume_attr.attr,
|
|
&image_size_attr.attr,
|
|
NULL,
|
|
};
|
|
|
|
|
|
static struct attribute_group attr_group = {
|
|
.attrs = g,
|
|
};
|
|
|
|
|
|
static int __init pm_disk_init(void)
|
|
{
|
|
return sysfs_create_group(&power_subsys.kset.kobj,&attr_group);
|
|
}
|
|
|
|
core_initcall(pm_disk_init);
|
|
|
|
|
|
static int __init resume_setup(char *str)
|
|
{
|
|
if (noresume)
|
|
return 1;
|
|
|
|
strncpy( resume_file, str, 255 );
|
|
return 1;
|
|
}
|
|
|
|
static int __init resume_offset_setup(char *str)
|
|
{
|
|
unsigned long long offset;
|
|
|
|
if (noresume)
|
|
return 1;
|
|
|
|
if (sscanf(str, "%llu", &offset) == 1)
|
|
swsusp_resume_block = offset;
|
|
|
|
return 1;
|
|
}
|
|
|
|
static int __init noresume_setup(char *str)
|
|
{
|
|
noresume = 1;
|
|
return 1;
|
|
}
|
|
|
|
__setup("noresume", noresume_setup);
|
|
__setup("resume_offset=", resume_offset_setup);
|
|
__setup("resume=", resume_setup);
|