1 // SPDX-License-Identifier: GPL-2.0-only
3 * linux/kernel/reboot.c
5 * Copyright (C) 2013 Linus Torvalds
8 #define pr_fmt(fmt) "reboot: " fmt
10 #include <linux/ctype.h>
11 #include <linux/export.h>
12 #include <linux/kexec.h>
13 #include <linux/kmod.h>
14 #include <linux/kmsg_dump.h>
15 #include <linux/reboot.h>
16 #include <linux/suspend.h>
17 #include <linux/syscalls.h>
18 #include <linux/syscore_ops.h>
19 #include <linux/uaccess.h>
22 * this indicates whether you can reboot with ctrl-alt-del: the default is yes
27 EXPORT_SYMBOL(cad_pid
);
29 #if defined(CONFIG_ARM) || defined(CONFIG_UNICORE32)
30 #define DEFAULT_REBOOT_MODE = REBOOT_HARD
32 #define DEFAULT_REBOOT_MODE
34 enum reboot_mode reboot_mode DEFAULT_REBOOT_MODE
;
35 enum reboot_mode panic_reboot_mode
= REBOOT_UNDEFINED
;
38 * This variable is used privately to keep track of whether or not
39 * reboot_type is still set to its default value (i.e., reboot= hasn't
40 * been set on the command line). This is needed so that we can
41 * suppress DMI scanning for reboot quirks. Without it, it's
42 * impossible to override a faulty reboot quirk without recompiling.
44 int reboot_default
= 1;
46 enum reboot_type reboot_type
= BOOT_ACPI
;
50 * If set, this is used for preparing the system to power off.
53 void (*pm_power_off_prepare
)(void);
54 EXPORT_SYMBOL_GPL(pm_power_off_prepare
);
57 * emergency_restart - reboot the system
59 * Without shutting down any hardware or taking any locks
60 * reboot the system. This is called when we know we are in
61 * trouble so this is our best effort to reboot. This is
62 * safe to call in interrupt context.
64 void emergency_restart(void)
66 kmsg_dump(KMSG_DUMP_EMERG
);
67 machine_emergency_restart();
69 EXPORT_SYMBOL_GPL(emergency_restart
);
71 void kernel_restart_prepare(char *cmd
)
73 blocking_notifier_call_chain(&reboot_notifier_list
, SYS_RESTART
, cmd
);
74 system_state
= SYSTEM_RESTART
;
75 usermodehelper_disable();
80 * register_reboot_notifier - Register function to be called at reboot time
81 * @nb: Info about notifier function to be called
83 * Registers a function with the list of functions
84 * to be called at reboot time.
86 * Currently always returns zero, as blocking_notifier_chain_register()
87 * always returns zero.
89 int register_reboot_notifier(struct notifier_block
*nb
)
91 return blocking_notifier_chain_register(&reboot_notifier_list
, nb
);
93 EXPORT_SYMBOL(register_reboot_notifier
);
96 * unregister_reboot_notifier - Unregister previously registered reboot notifier
97 * @nb: Hook to be unregistered
99 * Unregisters a previously registered reboot
102 * Returns zero on success, or %-ENOENT on failure.
104 int unregister_reboot_notifier(struct notifier_block
*nb
)
106 return blocking_notifier_chain_unregister(&reboot_notifier_list
, nb
);
108 EXPORT_SYMBOL(unregister_reboot_notifier
);
110 static void devm_unregister_reboot_notifier(struct device
*dev
, void *res
)
112 WARN_ON(unregister_reboot_notifier(*(struct notifier_block
**)res
));
115 int devm_register_reboot_notifier(struct device
*dev
, struct notifier_block
*nb
)
117 struct notifier_block
**rcnb
;
120 rcnb
= devres_alloc(devm_unregister_reboot_notifier
,
121 sizeof(*rcnb
), GFP_KERNEL
);
125 ret
= register_reboot_notifier(nb
);
128 devres_add(dev
, rcnb
);
135 EXPORT_SYMBOL(devm_register_reboot_notifier
);
138 * Notifier list for kernel code which wants to be called
139 * to restart the system.
141 static ATOMIC_NOTIFIER_HEAD(restart_handler_list
);
144 * register_restart_handler - Register function to be called to reset
146 * @nb: Info about handler function to be called
147 * @nb->priority: Handler priority. Handlers should follow the
148 * following guidelines for setting priorities.
149 * 0: Restart handler of last resort,
150 * with limited restart capabilities
151 * 128: Default restart handler; use if no other
152 * restart handler is expected to be available,
153 * and/or if restart functionality is
154 * sufficient to restart the entire system
155 * 255: Highest priority restart handler, will
156 * preempt all other restart handlers
158 * Registers a function with code to be called to restart the
161 * Registered functions will be called from machine_restart as last
162 * step of the restart sequence (if the architecture specific
163 * machine_restart function calls do_kernel_restart - see below
165 * Registered functions are expected to restart the system immediately.
166 * If more than one function is registered, the restart handler priority
167 * selects which function will be called first.
169 * Restart handlers are expected to be registered from non-architecture
170 * code, typically from drivers. A typical use case would be a system
171 * where restart functionality is provided through a watchdog. Multiple
172 * restart handlers may exist; for example, one restart handler might
173 * restart the entire system, while another only restarts the CPU.
174 * In such cases, the restart handler which only restarts part of the
175 * hardware is expected to register with low priority to ensure that
176 * it only runs if no other means to restart the system is available.
178 * Currently always returns zero, as atomic_notifier_chain_register()
179 * always returns zero.
181 int register_restart_handler(struct notifier_block
*nb
)
183 return atomic_notifier_chain_register(&restart_handler_list
, nb
);
185 EXPORT_SYMBOL(register_restart_handler
);
188 * unregister_restart_handler - Unregister previously registered
190 * @nb: Hook to be unregistered
192 * Unregisters a previously registered restart handler function.
194 * Returns zero on success, or %-ENOENT on failure.
196 int unregister_restart_handler(struct notifier_block
*nb
)
198 return atomic_notifier_chain_unregister(&restart_handler_list
, nb
);
200 EXPORT_SYMBOL(unregister_restart_handler
);
203 * do_kernel_restart - Execute kernel restart handler call chain
205 * Calls functions registered with register_restart_handler.
207 * Expected to be called from machine_restart as last step of the restart
210 * Restarts the system immediately if a restart handler function has been
211 * registered. Otherwise does nothing.
213 void do_kernel_restart(char *cmd
)
215 atomic_notifier_call_chain(&restart_handler_list
, reboot_mode
, cmd
);
218 void migrate_to_reboot_cpu(void)
220 /* The boot cpu is always logical cpu 0 */
221 int cpu
= reboot_cpu
;
223 cpu_hotplug_disable();
225 /* Make certain the cpu I'm about to reboot on is online */
226 if (!cpu_online(cpu
))
227 cpu
= cpumask_first(cpu_online_mask
);
229 /* Prevent races with other tasks migrating this task */
230 current
->flags
|= PF_NO_SETAFFINITY
;
232 /* Make certain I only run on the appropriate processor */
233 set_cpus_allowed_ptr(current
, cpumask_of(cpu
));
237 * kernel_restart - reboot the system
238 * @cmd: pointer to buffer containing command to execute for restart
241 * Shutdown everything and perform a clean reboot.
242 * This is not safe to call in interrupt context.
244 void kernel_restart(char *cmd
)
246 kernel_restart_prepare(cmd
);
247 migrate_to_reboot_cpu();
250 pr_emerg("Restarting system\n");
252 pr_emerg("Restarting system with command '%s'\n", cmd
);
253 kmsg_dump(KMSG_DUMP_RESTART
);
254 machine_restart(cmd
);
256 EXPORT_SYMBOL_GPL(kernel_restart
);
258 static void kernel_shutdown_prepare(enum system_states state
)
260 blocking_notifier_call_chain(&reboot_notifier_list
,
261 (state
== SYSTEM_HALT
) ? SYS_HALT
: SYS_POWER_OFF
, NULL
);
262 system_state
= state
;
263 usermodehelper_disable();
267 * kernel_halt - halt the system
269 * Shutdown everything and perform a clean system halt.
271 void kernel_halt(void)
273 kernel_shutdown_prepare(SYSTEM_HALT
);
274 migrate_to_reboot_cpu();
276 pr_emerg("System halted\n");
277 kmsg_dump(KMSG_DUMP_HALT
);
280 EXPORT_SYMBOL_GPL(kernel_halt
);
283 * kernel_power_off - power_off the system
285 * Shutdown everything and perform a clean system power_off.
287 void kernel_power_off(void)
289 kernel_shutdown_prepare(SYSTEM_POWER_OFF
);
290 if (pm_power_off_prepare
)
291 pm_power_off_prepare();
292 migrate_to_reboot_cpu();
294 pr_emerg("Power down\n");
295 kmsg_dump(KMSG_DUMP_POWEROFF
);
298 EXPORT_SYMBOL_GPL(kernel_power_off
);
300 DEFINE_MUTEX(system_transition_mutex
);
303 * Reboot system call: for obvious reasons only root may call it,
304 * and even root needs to set up some magic numbers in the registers
305 * so that some mistake won't make this reboot the whole machine.
306 * You can also set the meaning of the ctrl-alt-del-key here.
308 * reboot doesn't sync: do that yourself before calling this.
310 SYSCALL_DEFINE4(reboot
, int, magic1
, int, magic2
, unsigned int, cmd
,
313 struct pid_namespace
*pid_ns
= task_active_pid_ns(current
);
317 /* We only trust the superuser with rebooting the system. */
318 if (!ns_capable(pid_ns
->user_ns
, CAP_SYS_BOOT
))
321 /* For safety, we require "magic" arguments. */
322 if (magic1
!= LINUX_REBOOT_MAGIC1
||
323 (magic2
!= LINUX_REBOOT_MAGIC2
&&
324 magic2
!= LINUX_REBOOT_MAGIC2A
&&
325 magic2
!= LINUX_REBOOT_MAGIC2B
&&
326 magic2
!= LINUX_REBOOT_MAGIC2C
))
330 * If pid namespaces are enabled and the current task is in a child
331 * pid_namespace, the command is handled by reboot_pid_ns() which will
334 ret
= reboot_pid_ns(pid_ns
, cmd
);
338 /* Instead of trying to make the power_off code look like
339 * halt when pm_power_off is not set do it the easy way.
341 if ((cmd
== LINUX_REBOOT_CMD_POWER_OFF
) && !pm_power_off
)
342 cmd
= LINUX_REBOOT_CMD_HALT
;
344 mutex_lock(&system_transition_mutex
);
346 case LINUX_REBOOT_CMD_RESTART
:
347 kernel_restart(NULL
);
350 case LINUX_REBOOT_CMD_CAD_ON
:
354 case LINUX_REBOOT_CMD_CAD_OFF
:
358 case LINUX_REBOOT_CMD_HALT
:
361 panic("cannot halt");
363 case LINUX_REBOOT_CMD_POWER_OFF
:
368 case LINUX_REBOOT_CMD_RESTART2
:
369 ret
= strncpy_from_user(&buffer
[0], arg
, sizeof(buffer
) - 1);
374 buffer
[sizeof(buffer
) - 1] = '\0';
376 kernel_restart(buffer
);
379 #ifdef CONFIG_KEXEC_CORE
380 case LINUX_REBOOT_CMD_KEXEC
:
381 ret
= kernel_kexec();
385 #ifdef CONFIG_HIBERNATION
386 case LINUX_REBOOT_CMD_SW_SUSPEND
:
395 mutex_unlock(&system_transition_mutex
);
399 static void deferred_cad(struct work_struct
*dummy
)
401 kernel_restart(NULL
);
405 * This function gets called by ctrl-alt-del - ie the keyboard interrupt.
406 * As it's called within an interrupt, it may NOT sync: the only choice
407 * is whether to reboot at once, or just ignore the ctrl-alt-del.
409 void ctrl_alt_del(void)
411 static DECLARE_WORK(cad_work
, deferred_cad
);
414 schedule_work(&cad_work
);
416 kill_cad_pid(SIGINT
, 1);
419 char poweroff_cmd
[POWEROFF_CMD_PATH_LEN
] = "/sbin/poweroff";
420 static const char reboot_cmd
[] = "/sbin/reboot";
422 static int run_cmd(const char *cmd
)
425 static char *envp
[] = {
427 "PATH=/sbin:/bin:/usr/sbin:/usr/bin",
431 argv
= argv_split(GFP_KERNEL
, cmd
, NULL
);
433 ret
= call_usermodehelper(argv
[0], argv
, envp
, UMH_WAIT_EXEC
);
442 static int __orderly_reboot(void)
446 ret
= run_cmd(reboot_cmd
);
449 pr_warn("Failed to start orderly reboot: forcing the issue\n");
451 kernel_restart(NULL
);
457 static int __orderly_poweroff(bool force
)
461 ret
= run_cmd(poweroff_cmd
);
464 pr_warn("Failed to start orderly shutdown: forcing the issue\n");
467 * I guess this should try to kick off some daemon to sync and
468 * poweroff asap. Or not even bother syncing if we're doing an
469 * emergency shutdown?
478 static bool poweroff_force
;
480 static void poweroff_work_func(struct work_struct
*work
)
482 __orderly_poweroff(poweroff_force
);
485 static DECLARE_WORK(poweroff_work
, poweroff_work_func
);
488 * orderly_poweroff - Trigger an orderly system poweroff
489 * @force: force poweroff if command execution fails
491 * This may be called from any context to trigger a system shutdown.
492 * If the orderly shutdown fails, it will force an immediate shutdown.
494 void orderly_poweroff(bool force
)
496 if (force
) /* do not override the pending "true" */
497 poweroff_force
= true;
498 schedule_work(&poweroff_work
);
500 EXPORT_SYMBOL_GPL(orderly_poweroff
);
502 static void reboot_work_func(struct work_struct
*work
)
507 static DECLARE_WORK(reboot_work
, reboot_work_func
);
510 * orderly_reboot - Trigger an orderly system reboot
512 * This may be called from any context to trigger a system reboot.
513 * If the orderly reboot fails, it will force an immediate reboot.
515 void orderly_reboot(void)
517 schedule_work(&reboot_work
);
519 EXPORT_SYMBOL_GPL(orderly_reboot
);
521 static int __init
reboot_setup(char *str
)
524 enum reboot_mode
*mode
;
527 * Having anything passed on the command line via
528 * reboot= will cause us to disable DMI checking
533 if (!strncmp(str
, "panic_", 6)) {
534 mode
= &panic_reboot_mode
;
557 if (isdigit(*(str
+1))) {
558 rc
= kstrtoint(str
+1, 0, &reboot_cpu
);
561 } else if (str
[1] == 'm' && str
[2] == 'p' &&
563 rc
= kstrtoint(str
+3, 0, &reboot_cpu
);
588 str
= strchr(str
, ',');
596 __setup("reboot=", reboot_setup
);