1 // SPDX-License-Identifier: GPL-2.0-only
3 * kernel/power/hibernate.c - Hibernation (a.k.a suspend-to-disk) support.
5 * Copyright (c) 2003 Patrick Mochel
6 * Copyright (c) 2003 Open Source Development Lab
7 * Copyright (c) 2004 Pavel Machek <pavel@ucw.cz>
8 * Copyright (c) 2009 Rafael J. Wysocki, Novell Inc.
9 * Copyright (C) 2012 Bojan Smojver <bojan@rexursive.com>
12 #define pr_fmt(fmt) "PM: hibernation: " fmt
14 #include <linux/blkdev.h>
15 #include <linux/export.h>
16 #include <linux/suspend.h>
17 #include <linux/reboot.h>
18 #include <linux/string.h>
19 #include <linux/device.h>
20 #include <linux/async.h>
21 #include <linux/delay.h>
23 #include <linux/mount.h>
25 #include <linux/nmi.h>
26 #include <linux/console.h>
27 #include <linux/cpu.h>
28 #include <linux/freezer.h>
29 #include <linux/gfp.h>
30 #include <linux/syscore_ops.h>
31 #include <linux/ctype.h>
32 #include <linux/ktime.h>
33 #include <linux/security.h>
34 #include <linux/secretmem.h>
35 #include <trace/events/power.h>
40 static int nocompress
;
42 static int nohibernate
;
43 static int resume_wait
;
44 static unsigned int resume_delay
;
45 static char resume_file
[256] = CONFIG_PM_STD_PARTITION
;
46 dev_t swsusp_resume_device
;
47 sector_t swsusp_resume_block
;
48 __visible
int in_suspend __nosavedata
;
50 static char hibernate_compressor
[CRYPTO_MAX_ALG_NAME
] = CONFIG_HIBERNATION_DEF_COMP
;
53 * Compression/decompression algorithm to be used while saving/loading
54 * image to/from disk. This would later be used in 'kernel/power/swap.c'
55 * to allocate comp streams.
57 char hib_comp_algo
[CRYPTO_MAX_ALG_NAME
];
67 HIBERNATION_TEST_RESUME
,
69 __HIBERNATION_AFTER_LAST
71 #define HIBERNATION_MAX (__HIBERNATION_AFTER_LAST-1)
72 #define HIBERNATION_FIRST (HIBERNATION_INVALID + 1)
74 static int hibernation_mode
= HIBERNATION_SHUTDOWN
;
76 bool freezer_test_done
;
78 static const struct platform_hibernation_ops
*hibernation_ops
;
80 static atomic_t hibernate_atomic
= ATOMIC_INIT(1);
82 bool hibernate_acquire(void)
84 return atomic_add_unless(&hibernate_atomic
, -1, 0);
87 void hibernate_release(void)
89 atomic_inc(&hibernate_atomic
);
92 bool hibernation_available(void)
94 return nohibernate
== 0 &&
95 !security_locked_down(LOCKDOWN_HIBERNATION
) &&
96 !secretmem_active() && !cxl_mem_active();
100 * hibernation_set_ops - Set the global hibernate operations.
101 * @ops: Hibernation operations to use in subsequent hibernation transitions.
103 void hibernation_set_ops(const struct platform_hibernation_ops
*ops
)
105 unsigned int sleep_flags
;
107 if (ops
&& !(ops
->begin
&& ops
->end
&& ops
->pre_snapshot
108 && ops
->prepare
&& ops
->finish
&& ops
->enter
&& ops
->pre_restore
109 && ops
->restore_cleanup
&& ops
->leave
)) {
114 sleep_flags
= lock_system_sleep();
116 hibernation_ops
= ops
;
118 hibernation_mode
= HIBERNATION_PLATFORM
;
119 else if (hibernation_mode
== HIBERNATION_PLATFORM
)
120 hibernation_mode
= HIBERNATION_SHUTDOWN
;
122 unlock_system_sleep(sleep_flags
);
124 EXPORT_SYMBOL_GPL(hibernation_set_ops
);
126 static bool entering_platform_hibernation
;
128 bool system_entering_hibernation(void)
130 return entering_platform_hibernation
;
132 EXPORT_SYMBOL(system_entering_hibernation
);
134 #ifdef CONFIG_PM_DEBUG
135 static void hibernation_debug_sleep(void)
137 pr_info("debug: Waiting for 5 seconds.\n");
141 static int hibernation_test(int level
)
143 if (pm_test_level
== level
) {
144 hibernation_debug_sleep();
149 #else /* !CONFIG_PM_DEBUG */
150 static int hibernation_test(int level
) { return 0; }
151 #endif /* !CONFIG_PM_DEBUG */
154 * platform_begin - Call platform to start hibernation.
155 * @platform_mode: Whether or not to use the platform driver.
157 static int platform_begin(int platform_mode
)
159 return (platform_mode
&& hibernation_ops
) ?
160 hibernation_ops
->begin(PMSG_FREEZE
) : 0;
164 * platform_end - Call platform to finish transition to the working state.
165 * @platform_mode: Whether or not to use the platform driver.
167 static void platform_end(int platform_mode
)
169 if (platform_mode
&& hibernation_ops
)
170 hibernation_ops
->end();
174 * platform_pre_snapshot - Call platform to prepare the machine for hibernation.
175 * @platform_mode: Whether or not to use the platform driver.
177 * Use the platform driver to prepare the system for creating a hibernate image,
178 * if so configured, and return an error code if that fails.
181 static int platform_pre_snapshot(int platform_mode
)
183 return (platform_mode
&& hibernation_ops
) ?
184 hibernation_ops
->pre_snapshot() : 0;
188 * platform_leave - Call platform to prepare a transition to the working state.
189 * @platform_mode: Whether or not to use the platform driver.
191 * Use the platform driver prepare to prepare the machine for switching to the
192 * normal mode of operation.
194 * This routine is called on one CPU with interrupts disabled.
196 static void platform_leave(int platform_mode
)
198 if (platform_mode
&& hibernation_ops
)
199 hibernation_ops
->leave();
203 * platform_finish - Call platform to switch the system to the working state.
204 * @platform_mode: Whether or not to use the platform driver.
206 * Use the platform driver to switch the machine to the normal mode of
209 * This routine must be called after platform_prepare().
211 static void platform_finish(int platform_mode
)
213 if (platform_mode
&& hibernation_ops
)
214 hibernation_ops
->finish();
218 * platform_pre_restore - Prepare for hibernate image restoration.
219 * @platform_mode: Whether or not to use the platform driver.
221 * Use the platform driver to prepare the system for resume from a hibernation
224 * If the restore fails after this function has been called,
225 * platform_restore_cleanup() must be called.
227 static int platform_pre_restore(int platform_mode
)
229 return (platform_mode
&& hibernation_ops
) ?
230 hibernation_ops
->pre_restore() : 0;
234 * platform_restore_cleanup - Switch to the working state after failing restore.
235 * @platform_mode: Whether or not to use the platform driver.
237 * Use the platform driver to switch the system to the normal mode of operation
238 * after a failing restore.
240 * If platform_pre_restore() has been called before the failing restore, this
241 * function must be called too, regardless of the result of
242 * platform_pre_restore().
244 static void platform_restore_cleanup(int platform_mode
)
246 if (platform_mode
&& hibernation_ops
)
247 hibernation_ops
->restore_cleanup();
251 * platform_recover - Recover from a failure to suspend devices.
252 * @platform_mode: Whether or not to use the platform driver.
254 static void platform_recover(int platform_mode
)
256 if (platform_mode
&& hibernation_ops
&& hibernation_ops
->recover
)
257 hibernation_ops
->recover();
261 * swsusp_show_speed - Print time elapsed between two events during hibernation.
262 * @start: Starting event.
263 * @stop: Final event.
264 * @nr_pages: Number of memory pages processed between @start and @stop.
265 * @msg: Additional diagnostic message to print.
267 void swsusp_show_speed(ktime_t start
, ktime_t stop
,
268 unsigned nr_pages
, char *msg
)
271 u64 elapsed_centisecs64
;
272 unsigned int centisecs
;
276 diff
= ktime_sub(stop
, start
);
277 elapsed_centisecs64
= ktime_divns(diff
, 10*NSEC_PER_MSEC
);
278 centisecs
= elapsed_centisecs64
;
280 centisecs
= 1; /* avoid div-by-zero */
281 k
= nr_pages
* (PAGE_SIZE
/ 1024);
282 kps
= (k
* 100) / centisecs
;
283 pr_info("%s %u kbytes in %u.%02u seconds (%u.%02u MB/s)\n",
284 msg
, k
, centisecs
/ 100, centisecs
% 100, kps
/ 1000,
288 __weak
int arch_resume_nosmt(void)
294 * create_image - Create a hibernation image.
295 * @platform_mode: Whether or not to use the platform driver.
297 * Execute device drivers' "late" and "noirq" freeze callbacks, create a
298 * hibernation image and run the drivers' "noirq" and "early" thaw callbacks.
300 * Control reappears in this routine after the subsequent restore.
302 static int create_image(int platform_mode
)
306 error
= dpm_suspend_end(PMSG_FREEZE
);
308 pr_err("Some devices failed to power down, aborting\n");
312 error
= platform_pre_snapshot(platform_mode
);
313 if (error
|| hibernation_test(TEST_PLATFORM
))
314 goto Platform_finish
;
316 error
= pm_sleep_disable_secondary_cpus();
317 if (error
|| hibernation_test(TEST_CPUS
))
322 system_state
= SYSTEM_SUSPEND
;
324 error
= syscore_suspend();
326 pr_err("Some system devices failed to power down, aborting\n");
330 if (hibernation_test(TEST_CORE
) || pm_wakeup_pending())
334 save_processor_state();
335 trace_suspend_resume(TPS("machine_suspend"), PM_EVENT_HIBERNATE
, true);
336 error
= swsusp_arch_suspend();
337 /* Restore control flow magically appears here */
338 restore_processor_state();
339 trace_suspend_resume(TPS("machine_suspend"), PM_EVENT_HIBERNATE
, false);
341 pr_err("Error %d creating image\n", error
);
344 events_check_enabled
= false;
345 clear_or_poison_free_pages();
348 platform_leave(platform_mode
);
354 system_state
= SYSTEM_RUNNING
;
358 pm_sleep_enable_secondary_cpus();
360 /* Allow architectures to do nosmt-specific post-resume dances */
362 error
= arch_resume_nosmt();
365 platform_finish(platform_mode
);
367 dpm_resume_start(in_suspend
?
368 (error
? PMSG_RECOVER
: PMSG_THAW
) : PMSG_RESTORE
);
374 * hibernation_snapshot - Quiesce devices and create a hibernation image.
375 * @platform_mode: If set, use platform driver to prepare for the transition.
377 * This routine must be called with system_transition_mutex held.
379 int hibernation_snapshot(int platform_mode
)
384 pm_suspend_clear_flags();
385 error
= platform_begin(platform_mode
);
389 /* Preallocate image memory before shutting down devices. */
390 error
= hibernate_preallocate_memory();
394 error
= freeze_kernel_threads();
398 if (hibernation_test(TEST_FREEZER
)) {
401 * Indicate to the caller that we are returning due to a
402 * successful freezer test.
404 freezer_test_done
= true;
408 error
= dpm_prepare(PMSG_FREEZE
);
410 dpm_complete(PMSG_RECOVER
);
415 pm_restrict_gfp_mask();
417 error
= dpm_suspend(PMSG_FREEZE
);
419 if (error
|| hibernation_test(TEST_DEVICES
))
420 platform_recover(platform_mode
);
422 error
= create_image(platform_mode
);
425 * In the case that we call create_image() above, the control
426 * returns here (1) after the image has been created or the
427 * image creation has failed and (2) after a successful restore.
430 /* We may need to release the preallocated image pages here. */
431 if (error
|| !in_suspend
)
434 msg
= in_suspend
? (error
? PMSG_RECOVER
: PMSG_THAW
) : PMSG_RESTORE
;
437 if (error
|| !in_suspend
)
438 pm_restore_gfp_mask();
444 platform_end(platform_mode
);
448 thaw_kernel_threads();
454 int __weak
hibernate_resume_nonboot_cpu_disable(void)
456 return suspend_disable_secondary_cpus();
460 * resume_target_kernel - Restore system state from a hibernation image.
461 * @platform_mode: Whether or not to use the platform driver.
463 * Execute device drivers' "noirq" and "late" freeze callbacks, restore the
464 * contents of highmem that have not been restored yet from the image and run
465 * the low-level code that will restore the remaining contents of memory and
466 * switch to the just restored target kernel.
468 static int resume_target_kernel(bool platform_mode
)
472 error
= dpm_suspend_end(PMSG_QUIESCE
);
474 pr_err("Some devices failed to power down, aborting resume\n");
478 error
= platform_pre_restore(platform_mode
);
484 error
= hibernate_resume_nonboot_cpu_disable();
489 system_state
= SYSTEM_SUSPEND
;
491 error
= syscore_suspend();
495 save_processor_state();
496 error
= restore_highmem();
498 error
= swsusp_arch_resume();
500 * The code below is only ever reached in case of a failure.
501 * Otherwise, execution continues at the place where
502 * swsusp_arch_suspend() was called.
506 * This call to restore_highmem() reverts the changes made by
512 * The only reason why swsusp_arch_resume() can fail is memory being
513 * very tight, so we have to free it as soon as we can to avoid
514 * subsequent failures.
517 restore_processor_state();
518 touch_softlockup_watchdog();
523 system_state
= SYSTEM_RUNNING
;
527 pm_sleep_enable_secondary_cpus();
530 platform_restore_cleanup(platform_mode
);
532 dpm_resume_start(PMSG_RECOVER
);
538 * hibernation_restore - Quiesce devices and restore from a hibernation image.
539 * @platform_mode: If set, use platform driver to prepare for the transition.
541 * This routine must be called with system_transition_mutex held. If it is
542 * successful, control reappears in the restored target kernel in
543 * hibernation_snapshot().
545 int hibernation_restore(int platform_mode
)
549 pm_prepare_console();
551 pm_restrict_gfp_mask();
552 error
= dpm_suspend_start(PMSG_QUIESCE
);
554 error
= resume_target_kernel(platform_mode
);
556 * The above should either succeed and jump to the new kernel,
557 * or return with an error. Otherwise things are just
558 * undefined, so let's be paranoid.
562 dpm_resume_end(PMSG_RECOVER
);
563 pm_restore_gfp_mask();
565 pm_restore_console();
570 * hibernation_platform_enter - Power off the system using the platform driver.
572 int hibernation_platform_enter(void)
576 if (!hibernation_ops
)
580 * We have cancelled the power transition by running
581 * hibernation_ops->finish() before saving the image, so we should let
582 * the firmware know that we're going to enter the sleep state after all
584 error
= hibernation_ops
->begin(PMSG_HIBERNATE
);
588 entering_platform_hibernation
= true;
590 error
= dpm_suspend_start(PMSG_HIBERNATE
);
592 if (hibernation_ops
->recover
)
593 hibernation_ops
->recover();
597 error
= dpm_suspend_end(PMSG_HIBERNATE
);
601 error
= hibernation_ops
->prepare();
603 goto Platform_finish
;
605 error
= pm_sleep_disable_secondary_cpus();
610 system_state
= SYSTEM_SUSPEND
;
612 if (pm_wakeup_pending()) {
617 hibernation_ops
->enter();
618 /* We should never get here */
623 system_state
= SYSTEM_RUNNING
;
627 pm_sleep_enable_secondary_cpus();
630 hibernation_ops
->finish();
632 dpm_resume_start(PMSG_RESTORE
);
635 entering_platform_hibernation
= false;
636 dpm_resume_end(PMSG_RESTORE
);
640 hibernation_ops
->end();
646 * power_down - Shut the machine down for hibernation.
648 * Use the platform driver, if configured, to put the system into the sleep
649 * state corresponding to hibernation, or try to power it off or reboot,
650 * depending on the value of hibernation_mode.
652 static void power_down(void)
656 #ifdef CONFIG_SUSPEND
657 if (hibernation_mode
== HIBERNATION_SUSPEND
) {
658 error
= suspend_devices_and_enter(mem_sleep_current
);
660 hibernation_mode
= hibernation_ops
?
661 HIBERNATION_PLATFORM
:
662 HIBERNATION_SHUTDOWN
;
664 /* Restore swap signature. */
665 error
= swsusp_unmark();
667 pr_err("Swap will be unusable! Try swapon -a.\n");
674 switch (hibernation_mode
) {
675 case HIBERNATION_REBOOT
:
676 kernel_restart(NULL
);
678 case HIBERNATION_PLATFORM
:
679 error
= hibernation_platform_enter();
680 if (error
== -EAGAIN
|| error
== -EBUSY
) {
682 events_check_enabled
= false;
683 pr_info("Wakeup event detected during hibernation, rolling back.\n");
687 case HIBERNATION_SHUTDOWN
:
688 if (kernel_can_power_off()) {
689 entering_platform_hibernation
= true;
691 entering_platform_hibernation
= false;
697 * Valid image is on the disk, if we continue we risk serious data
698 * corruption after resume.
700 pr_crit("Power down manually\n");
705 static int load_image_and_restore(void)
710 pm_pr_dbg("Loading hibernation image.\n");
712 lock_device_hotplug();
713 error
= create_basic_memory_bitmaps();
719 error
= swsusp_read(&flags
);
722 error
= hibernation_restore(flags
& SF_PLATFORM_MODE
);
724 pr_err("Failed to load image, recovering.\n");
726 free_basic_memory_bitmaps();
728 unlock_device_hotplug();
733 #define COMPRESSION_ALGO_LZO "lzo"
734 #define COMPRESSION_ALGO_LZ4 "lz4"
737 * hibernate - Carry out system hibernation, including saving the image.
741 bool snapshot_test
= false;
742 unsigned int sleep_flags
;
745 if (!hibernation_available()) {
746 pm_pr_dbg("Hibernation not available.\n");
751 * Query for the compression algorithm support if compression is enabled.
754 strscpy(hib_comp_algo
, hibernate_compressor
, sizeof(hib_comp_algo
));
755 if (crypto_has_comp(hib_comp_algo
, 0, 0) != 1) {
756 pr_err("%s compression is not available\n", hib_comp_algo
);
761 sleep_flags
= lock_system_sleep();
762 /* The snapshot device should not be opened while we're running */
763 if (!hibernate_acquire()) {
768 pr_info("hibernation entry\n");
769 pm_prepare_console();
770 error
= pm_notifier_call_chain_robust(PM_HIBERNATION_PREPARE
, PM_POST_HIBERNATION
);
776 error
= freeze_processes();
780 lock_device_hotplug();
781 /* Allocate memory management structures */
782 error
= create_basic_memory_bitmaps();
786 error
= hibernation_snapshot(hibernation_mode
== HIBERNATION_PLATFORM
);
787 if (error
|| freezer_test_done
)
791 unsigned int flags
= 0;
793 if (hibernation_mode
== HIBERNATION_PLATFORM
)
794 flags
|= SF_PLATFORM_MODE
;
796 flags
|= SF_NOCOMPRESS_MODE
;
798 flags
|= SF_CRC32_MODE
;
801 * By default, LZO compression is enabled. Use SF_COMPRESSION_ALG_LZ4
802 * to override this behaviour and use LZ4.
804 * Refer kernel/power/power.h for more details
807 if (!strcmp(hib_comp_algo
, COMPRESSION_ALGO_LZ4
))
808 flags
|= SF_COMPRESSION_ALG_LZ4
;
810 flags
|= SF_COMPRESSION_ALG_LZO
;
813 pm_pr_dbg("Writing hibernation image.\n");
814 error
= swsusp_write(flags
);
817 if (hibernation_mode
== HIBERNATION_TEST_RESUME
)
818 snapshot_test
= true;
823 pm_restore_gfp_mask();
825 pm_pr_dbg("Hibernation image restored successfully.\n");
829 free_basic_memory_bitmaps();
831 unlock_device_hotplug();
833 pm_pr_dbg("Checking hibernation image\n");
834 error
= swsusp_check(false);
836 error
= load_image_and_restore();
840 /* Don't bother checking whether freezer_test_done is true */
841 freezer_test_done
= false;
843 pm_notifier_call_chain(PM_POST_HIBERNATION
);
845 pm_restore_console();
848 unlock_system_sleep(sleep_flags
);
849 pr_info("hibernation exit\n");
855 * hibernate_quiet_exec - Execute a function with all devices frozen.
856 * @func: Function to execute.
857 * @data: Data pointer to pass to @func.
859 * Return the @func return value or an error code if it cannot be executed.
861 int hibernate_quiet_exec(int (*func
)(void *data
), void *data
)
863 unsigned int sleep_flags
;
866 sleep_flags
= lock_system_sleep();
868 if (!hibernate_acquire()) {
873 pm_prepare_console();
875 error
= pm_notifier_call_chain_robust(PM_HIBERNATION_PREPARE
, PM_POST_HIBERNATION
);
879 error
= freeze_processes();
883 lock_device_hotplug();
885 pm_suspend_clear_flags();
887 error
= platform_begin(true);
891 error
= freeze_kernel_threads();
895 error
= dpm_prepare(PMSG_FREEZE
);
901 error
= dpm_suspend(PMSG_FREEZE
);
905 error
= dpm_suspend_end(PMSG_FREEZE
);
909 error
= platform_pre_snapshot(true);
916 platform_finish(true);
918 dpm_resume_start(PMSG_THAW
);
921 dpm_resume(PMSG_THAW
);
926 dpm_complete(PMSG_THAW
);
928 thaw_kernel_threads();
933 unlock_device_hotplug();
938 pm_notifier_call_chain(PM_POST_HIBERNATION
);
941 pm_restore_console();
946 unlock_system_sleep(sleep_flags
);
950 EXPORT_SYMBOL_GPL(hibernate_quiet_exec
);
952 static int __init
find_resume_device(void)
954 if (!strlen(resume_file
))
957 pm_pr_dbg("Checking hibernation image partition %s\n", resume_file
);
960 pr_info("Waiting %dsec before reading resume device ...\n",
962 ssleep(resume_delay
);
965 /* Check if the device is there */
966 if (!early_lookup_bdev(resume_file
, &swsusp_resume_device
))
970 * Some device discovery might still be in progress; we need to wait for
973 wait_for_device_probe();
975 while (early_lookup_bdev(resume_file
, &swsusp_resume_device
))
977 async_synchronize_full();
980 return early_lookup_bdev(resume_file
, &swsusp_resume_device
);
983 static int software_resume(void)
987 pm_pr_dbg("Hibernation image partition %d:%d present\n",
988 MAJOR(swsusp_resume_device
), MINOR(swsusp_resume_device
));
990 pm_pr_dbg("Looking for hibernation image.\n");
992 mutex_lock(&system_transition_mutex
);
993 error
= swsusp_check(true);
998 * Check if the hibernation image is compressed. If so, query for
999 * the algorithm support.
1001 if (!(swsusp_header_flags
& SF_NOCOMPRESS_MODE
)) {
1002 if (swsusp_header_flags
& SF_COMPRESSION_ALG_LZ4
)
1003 strscpy(hib_comp_algo
, COMPRESSION_ALGO_LZ4
, sizeof(hib_comp_algo
));
1005 strscpy(hib_comp_algo
, COMPRESSION_ALGO_LZO
, sizeof(hib_comp_algo
));
1006 if (crypto_has_comp(hib_comp_algo
, 0, 0) != 1) {
1007 pr_err("%s compression is not available\n", hib_comp_algo
);
1008 error
= -EOPNOTSUPP
;
1013 /* The snapshot device should not be opened while we're running */
1014 if (!hibernate_acquire()) {
1020 pr_info("resume from hibernation\n");
1021 pm_prepare_console();
1022 error
= pm_notifier_call_chain_robust(PM_RESTORE_PREPARE
, PM_POST_RESTORE
);
1026 pm_pr_dbg("Preparing processes for hibernation restore.\n");
1027 error
= freeze_processes();
1031 error
= freeze_kernel_threads();
1037 error
= load_image_and_restore();
1040 pm_notifier_call_chain(PM_POST_RESTORE
);
1042 pm_restore_console();
1043 pr_info("resume failed (%d)\n", error
);
1044 hibernate_release();
1045 /* For success case, the suspend path will release the lock */
1047 mutex_unlock(&system_transition_mutex
);
1048 pm_pr_dbg("Hibernation image not present or could not be loaded.\n");
1056 * software_resume_initcall - Resume from a saved hibernation image.
1058 * This routine is called as a late initcall, when all devices have been
1059 * discovered and initialized already.
1061 * The image reading code is called to see if there is a hibernation image
1062 * available for reading. If that is the case, devices are quiesced and the
1063 * contents of memory is restored from the saved image.
1065 * If this is successful, control reappears in the restored target kernel in
1066 * hibernation_snapshot() which returns to hibernate(). Otherwise, the routine
1067 * attempts to recover gracefully and make the kernel return to the normal mode
1070 static int __init
software_resume_initcall(void)
1073 * If the user said "noresume".. bail out early.
1075 if (noresume
|| !hibernation_available())
1078 if (!swsusp_resume_device
) {
1079 int error
= find_resume_device();
1085 return software_resume();
1087 late_initcall_sync(software_resume_initcall
);
1090 static const char * const hibernation_modes
[] = {
1091 [HIBERNATION_PLATFORM
] = "platform",
1092 [HIBERNATION_SHUTDOWN
] = "shutdown",
1093 [HIBERNATION_REBOOT
] = "reboot",
1094 #ifdef CONFIG_SUSPEND
1095 [HIBERNATION_SUSPEND
] = "suspend",
1097 [HIBERNATION_TEST_RESUME
] = "test_resume",
1101 * /sys/power/disk - Control hibernation mode.
1103 * Hibernation can be handled in several ways. There are a few different ways
1104 * to put the system into the sleep state: using the platform driver (e.g. ACPI
1105 * or other hibernation_ops), powering it off or rebooting it (for testing
1108 * The sysfs file /sys/power/disk provides an interface for selecting the
1109 * hibernation mode to use. Reading from this file causes the available modes
1110 * to be printed. There are 3 modes that can be supported:
1116 * If a platform hibernation driver is in use, 'platform' will be supported
1117 * and will be used by default. Otherwise, 'shutdown' will be used by default.
1118 * The selected option (i.e. the one corresponding to the current value of
1119 * hibernation_mode) is enclosed by a square bracket.
1121 * To select a given hibernation mode it is necessary to write the mode's
1122 * string representation (as returned by reading from /sys/power/disk) back
1123 * into /sys/power/disk.
1126 static ssize_t
disk_show(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1132 if (!hibernation_available())
1133 return sysfs_emit(buf
, "[disabled]\n");
1135 for (i
= HIBERNATION_FIRST
; i
<= HIBERNATION_MAX
; i
++) {
1136 if (!hibernation_modes
[i
])
1139 case HIBERNATION_SHUTDOWN
:
1140 case HIBERNATION_REBOOT
:
1141 #ifdef CONFIG_SUSPEND
1142 case HIBERNATION_SUSPEND
:
1144 case HIBERNATION_TEST_RESUME
:
1146 case HIBERNATION_PLATFORM
:
1147 if (hibernation_ops
)
1149 /* not a valid mode, continue with loop */
1152 if (i
== hibernation_mode
)
1153 count
+= sysfs_emit_at(buf
, count
, "[%s] ", hibernation_modes
[i
]);
1155 count
+= sysfs_emit_at(buf
, count
, "%s ", hibernation_modes
[i
]);
1158 /* Convert the last space to a newline if needed. */
1160 buf
[count
- 1] = '\n';
1165 static ssize_t
disk_store(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1166 const char *buf
, size_t n
)
1168 int mode
= HIBERNATION_INVALID
;
1169 unsigned int sleep_flags
;
1175 if (!hibernation_available())
1178 p
= memchr(buf
, '\n', n
);
1179 len
= p
? p
- buf
: n
;
1181 sleep_flags
= lock_system_sleep();
1182 for (i
= HIBERNATION_FIRST
; i
<= HIBERNATION_MAX
; i
++) {
1183 if (len
== strlen(hibernation_modes
[i
])
1184 && !strncmp(buf
, hibernation_modes
[i
], len
)) {
1189 if (mode
!= HIBERNATION_INVALID
) {
1191 case HIBERNATION_SHUTDOWN
:
1192 case HIBERNATION_REBOOT
:
1193 #ifdef CONFIG_SUSPEND
1194 case HIBERNATION_SUSPEND
:
1196 case HIBERNATION_TEST_RESUME
:
1197 hibernation_mode
= mode
;
1199 case HIBERNATION_PLATFORM
:
1200 if (hibernation_ops
)
1201 hibernation_mode
= mode
;
1209 pm_pr_dbg("Hibernation mode set to '%s'\n",
1210 hibernation_modes
[mode
]);
1211 unlock_system_sleep(sleep_flags
);
1212 return error
? error
: n
;
1217 static ssize_t
resume_show(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1220 return sysfs_emit(buf
, "%d:%d\n", MAJOR(swsusp_resume_device
),
1221 MINOR(swsusp_resume_device
));
1224 static ssize_t
resume_store(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1225 const char *buf
, size_t n
)
1227 unsigned int sleep_flags
;
1233 if (!hibernation_available())
1236 if (len
&& buf
[len
-1] == '\n')
1238 name
= kstrndup(buf
, len
, GFP_KERNEL
);
1242 error
= lookup_bdev(name
, &dev
);
1244 unsigned maj
, min
, offset
;
1248 if (sscanf(name
, "%u:%u%c", &maj
, &min
, &dummy
) == 2 ||
1249 sscanf(name
, "%u:%u:%u:%c", &maj
, &min
, &offset
,
1251 dev
= MKDEV(maj
, min
);
1252 if (maj
!= MAJOR(dev
) || min
!= MINOR(dev
))
1255 dev
= new_decode_dev(simple_strtoul(name
, &p
, 16));
1264 sleep_flags
= lock_system_sleep();
1265 swsusp_resume_device
= dev
;
1266 unlock_system_sleep(sleep_flags
);
1268 pm_pr_dbg("Configured hibernation resume from disk to %u\n",
1269 swsusp_resume_device
);
1277 static ssize_t
resume_offset_show(struct kobject
*kobj
,
1278 struct kobj_attribute
*attr
, char *buf
)
1280 return sysfs_emit(buf
, "%llu\n", (unsigned long long)swsusp_resume_block
);
1283 static ssize_t
resume_offset_store(struct kobject
*kobj
,
1284 struct kobj_attribute
*attr
, const char *buf
,
1287 unsigned long long offset
;
1290 rc
= kstrtoull(buf
, 0, &offset
);
1293 swsusp_resume_block
= offset
;
1298 power_attr(resume_offset
);
1300 static ssize_t
image_size_show(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1303 return sysfs_emit(buf
, "%lu\n", image_size
);
1306 static ssize_t
image_size_store(struct kobject
*kobj
, struct kobj_attribute
*attr
,
1307 const char *buf
, size_t n
)
1311 if (sscanf(buf
, "%lu", &size
) == 1) {
1319 power_attr(image_size
);
1321 static ssize_t
reserved_size_show(struct kobject
*kobj
,
1322 struct kobj_attribute
*attr
, char *buf
)
1324 return sysfs_emit(buf
, "%lu\n", reserved_size
);
1327 static ssize_t
reserved_size_store(struct kobject
*kobj
,
1328 struct kobj_attribute
*attr
,
1329 const char *buf
, size_t n
)
1333 if (sscanf(buf
, "%lu", &size
) == 1) {
1334 reserved_size
= size
;
1341 power_attr(reserved_size
);
1343 static struct attribute
*g
[] = {
1345 &resume_offset_attr
.attr
,
1347 &image_size_attr
.attr
,
1348 &reserved_size_attr
.attr
,
1353 static const struct attribute_group attr_group
= {
1358 static int __init
pm_disk_init(void)
1360 return sysfs_create_group(power_kobj
, &attr_group
);
1363 core_initcall(pm_disk_init
);
1366 static int __init
resume_setup(char *str
)
1371 strscpy(resume_file
, str
);
1375 static int __init
resume_offset_setup(char *str
)
1377 unsigned long long offset
;
1382 if (sscanf(str
, "%llu", &offset
) == 1)
1383 swsusp_resume_block
= offset
;
1388 static int __init
hibernate_setup(char *str
)
1390 if (!strncmp(str
, "noresume", 8)) {
1392 } else if (!strncmp(str
, "nocompress", 10)) {
1394 } else if (!strncmp(str
, "no", 2)) {
1397 } else if (IS_ENABLED(CONFIG_STRICT_KERNEL_RWX
)
1398 && !strncmp(str
, "protect_image", 13)) {
1399 enable_restore_image_protection();
1404 static int __init
noresume_setup(char *str
)
1410 static int __init
resumewait_setup(char *str
)
1416 static int __init
resumedelay_setup(char *str
)
1418 int rc
= kstrtouint(str
, 0, &resume_delay
);
1421 pr_warn("resumedelay: bad option string '%s'\n", str
);
1425 static int __init
nohibernate_setup(char *str
)
1432 static const char * const comp_alg_enabled
[] = {
1433 #if IS_ENABLED(CONFIG_CRYPTO_LZO)
1434 COMPRESSION_ALGO_LZO
,
1436 #if IS_ENABLED(CONFIG_CRYPTO_LZ4)
1437 COMPRESSION_ALGO_LZ4
,
1441 static int hibernate_compressor_param_set(const char *compressor
,
1442 const struct kernel_param
*kp
)
1444 unsigned int sleep_flags
;
1447 sleep_flags
= lock_system_sleep();
1449 index
= sysfs_match_string(comp_alg_enabled
, compressor
);
1451 ret
= param_set_copystring(comp_alg_enabled
[index
], kp
);
1453 strscpy(hib_comp_algo
, comp_alg_enabled
[index
],
1454 sizeof(hib_comp_algo
));
1459 unlock_system_sleep(sleep_flags
);
1462 pr_debug("Cannot set specified compressor %s\n",
1468 static const struct kernel_param_ops hibernate_compressor_param_ops
= {
1469 .set
= hibernate_compressor_param_set
,
1470 .get
= param_get_string
,
1473 static struct kparam_string hibernate_compressor_param_string
= {
1474 .maxlen
= sizeof(hibernate_compressor
),
1475 .string
= hibernate_compressor
,
1478 module_param_cb(compressor
, &hibernate_compressor_param_ops
,
1479 &hibernate_compressor_param_string
, 0644);
1480 MODULE_PARM_DESC(compressor
,
1481 "Compression algorithm to be used with hibernation");
1483 __setup("noresume", noresume_setup
);
1484 __setup("resume_offset=", resume_offset_setup
);
1485 __setup("resume=", resume_setup
);
1486 __setup("hibernate=", hibernate_setup
);
1487 __setup("resumewait", resumewait_setup
);
1488 __setup("resumedelay=", resumedelay_setup
);
1489 __setup("nohibernate", nohibernate_setup
);