2 * linux/kernel/power/user.c
4 * This file provides the user space interface for software suspend/resume.
6 * Copyright (C) 2006 Rafael J. Wysocki <rjw@sisk.pl>
8 * This file is released under the GPLv2.
12 #include <linux/suspend.h>
13 #include <linux/syscalls.h>
14 #include <linux/reboot.h>
15 #include <linux/string.h>
16 #include <linux/device.h>
17 #include <linux/miscdevice.h>
19 #include <linux/swap.h>
20 #include <linux/swapops.h>
23 #include <linux/console.h>
24 #include <linux/cpu.h>
25 #include <linux/freezer.h>
27 #include <asm/uaccess.h>
31 #define SNAPSHOT_MINOR 231
33 static struct snapshot_data {
34 struct snapshot_handle handle;
39 char platform_suspend;
42 atomic_t snapshot_device_available = ATOMIC_INIT(1);
44 static int snapshot_open(struct inode *inode, struct file *filp)
46 struct snapshot_data *data;
48 if (!atomic_add_unless(&snapshot_device_available, -1, 0))
51 if ((filp->f_flags & O_ACCMODE) == O_RDWR) {
52 atomic_inc(&snapshot_device_available);
55 if(create_basic_memory_bitmaps()) {
56 atomic_inc(&snapshot_device_available);
59 nonseekable_open(inode, filp);
60 data = &snapshot_state;
61 filp->private_data = data;
62 memset(&data->handle, 0, sizeof(struct snapshot_handle));
63 if ((filp->f_flags & O_ACCMODE) == O_RDONLY) {
64 data->swap = swsusp_resume_device ?
65 swap_type_of(swsusp_resume_device, 0, NULL) : -1;
66 data->mode = O_RDONLY;
69 data->mode = O_WRONLY;
73 data->platform_suspend = 0;
78 static int snapshot_release(struct inode *inode, struct file *filp)
80 struct snapshot_data *data;
83 free_basic_memory_bitmaps();
84 data = filp->private_data;
85 free_all_swap_pages(data->swap);
87 mutex_lock(&pm_mutex);
89 mutex_unlock(&pm_mutex);
91 atomic_inc(&snapshot_device_available);
95 static ssize_t snapshot_read(struct file *filp, char __user *buf,
96 size_t count, loff_t *offp)
98 struct snapshot_data *data;
101 data = filp->private_data;
104 res = snapshot_read_next(&data->handle, count);
106 if (copy_to_user(buf, data_of(data->handle), res))
109 *offp = data->handle.offset;
114 static ssize_t snapshot_write(struct file *filp, const char __user *buf,
115 size_t count, loff_t *offp)
117 struct snapshot_data *data;
120 data = filp->private_data;
121 res = snapshot_write_next(&data->handle, count);
123 if (copy_from_user(data_of(data->handle), buf, res))
126 *offp = data->handle.offset;
131 static inline int platform_prepare(void)
136 error = hibernation_ops->prepare();
141 static inline void platform_finish(void)
144 hibernation_ops->finish();
147 static inline int snapshot_suspend(int platform_suspend)
151 mutex_lock(&pm_mutex);
152 /* Free memory before shutting down devices. */
153 error = swsusp_shrink_memory();
157 if (platform_suspend) {
158 error = platform_prepare();
163 error = device_suspend(PMSG_FREEZE);
167 error = disable_nonboot_cpus();
170 error = swsusp_suspend();
172 enable_nonboot_cpus();
174 if (platform_suspend)
180 mutex_unlock(&pm_mutex);
184 static inline int snapshot_restore(void)
188 mutex_lock(&pm_mutex);
189 pm_prepare_console();
191 error = device_suspend(PMSG_PRETHAW);
195 error = disable_nonboot_cpus();
197 error = swsusp_resume();
199 enable_nonboot_cpus();
203 pm_restore_console();
204 mutex_unlock(&pm_mutex);
208 static int snapshot_ioctl(struct inode *inode, struct file *filp,
209 unsigned int cmd, unsigned long arg)
212 struct snapshot_data *data;
216 if (_IOC_TYPE(cmd) != SNAPSHOT_IOC_MAGIC)
218 if (_IOC_NR(cmd) > SNAPSHOT_IOC_MAXNR)
220 if (!capable(CAP_SYS_ADMIN))
223 data = filp->private_data;
227 case SNAPSHOT_FREEZE:
230 mutex_lock(&pm_mutex);
231 if (freeze_processes()) {
235 mutex_unlock(&pm_mutex);
240 case SNAPSHOT_UNFREEZE:
241 if (!data->frozen || data->ready)
243 mutex_lock(&pm_mutex);
245 mutex_unlock(&pm_mutex);
249 case SNAPSHOT_ATOMIC_SNAPSHOT:
250 if (data->mode != O_RDONLY || !data->frozen || data->ready) {
254 error = snapshot_suspend(data->platform_suspend);
256 error = put_user(in_suspend, (unsigned int __user *)arg);
261 case SNAPSHOT_ATOMIC_RESTORE:
262 snapshot_write_finalize(&data->handle);
263 if (data->mode != O_WRONLY || !data->frozen ||
264 !snapshot_image_loaded(&data->handle)) {
268 error = snapshot_restore();
273 memset(&data->handle, 0, sizeof(struct snapshot_handle));
277 case SNAPSHOT_SET_IMAGE_SIZE:
281 case SNAPSHOT_AVAIL_SWAP:
282 avail = count_swap_pages(data->swap, 1);
283 avail <<= PAGE_SHIFT;
284 error = put_user(avail, (loff_t __user *)arg);
287 case SNAPSHOT_GET_SWAP_PAGE:
288 if (data->swap < 0 || data->swap >= MAX_SWAPFILES) {
292 offset = alloc_swapdev_block(data->swap);
294 offset <<= PAGE_SHIFT;
295 error = put_user(offset, (sector_t __user *)arg);
301 case SNAPSHOT_FREE_SWAP_PAGES:
302 if (data->swap < 0 || data->swap >= MAX_SWAPFILES) {
306 free_all_swap_pages(data->swap);
309 case SNAPSHOT_SET_SWAP_FILE:
310 if (!swsusp_swap_in_use()) {
312 * User space encodes device types as two-byte values,
313 * so we need to recode them
315 if (old_decode_dev(arg)) {
316 data->swap = swap_type_of(old_decode_dev(arg),
340 if (!mutex_trylock(&pm_mutex)) {
345 if (pm_ops->prepare) {
346 error = pm_ops->prepare(PM_SUSPEND_MEM);
351 /* Put devices to sleep */
353 error = device_suspend(PMSG_SUSPEND);
355 printk(KERN_ERR "Failed to suspend some devices.\n");
357 error = disable_nonboot_cpus();
359 /* Enter S3, system is already frozen */
360 suspend_enter(PM_SUSPEND_MEM);
361 enable_nonboot_cpus();
363 /* Wake up devices */
368 pm_ops->finish(PM_SUSPEND_MEM);
371 mutex_unlock(&pm_mutex);
380 if (hibernation_ops) {
381 data->platform_suspend = 1;
389 if (data->platform_suspend) {
390 kernel_shutdown_prepare(SYSTEM_SUSPEND_DISK);
391 error = hibernation_ops->enter();
396 if (data->platform_suspend)
402 printk(KERN_ERR "SNAPSHOT_PMOPS: invalid argument %ld\n", arg);
407 case SNAPSHOT_SET_SWAP_AREA:
408 if (swsusp_swap_in_use()) {
411 struct resume_swap_area swap_area;
414 error = copy_from_user(&swap_area, (void __user *)arg,
415 sizeof(struct resume_swap_area));
422 * User space encodes device types as two-byte values,
423 * so we need to recode them
425 swdev = old_decode_dev(swap_area.dev);
427 offset = swap_area.offset;
428 data->swap = swap_type_of(swdev, offset, NULL);
446 static const struct file_operations snapshot_fops = {
447 .open = snapshot_open,
448 .release = snapshot_release,
449 .read = snapshot_read,
450 .write = snapshot_write,
452 .ioctl = snapshot_ioctl,
455 static struct miscdevice snapshot_device = {
456 .minor = SNAPSHOT_MINOR,
458 .fops = &snapshot_fops,
461 static int __init snapshot_device_init(void)
463 return misc_register(&snapshot_device);
466 device_initcall(snapshot_device_init);