orderly_poweroff(9)

🎀 orderly_poweroff(9) — NAME 🎀

hey bestie, welcome to orderly_poweroff(9) from the Kernel API Manual. This lil function is here to trigger an orderly system poweroff — like, bye-bye system, but the polite way first. ✨

🦋 SYNOPSIS 🦋

void orderly_poweroff (bool force );

🌸 ARGUMENTS 🌸

• force — force poweroff if command execution fails. That's the whole vibe: if running the command doesn't work out, this is the "fine, force it" switch. 💅

💖 DESCRIPTION 💖

Ok so here's the tea: you can call this from any context to trigger a system shutdown. No cap, any context. 🫶

And if the orderly shutdown fails? It will force an immediate shutdown. Like, it's not just gonna sit there and shrug — it goes straight to immediate mode. 😭🔥

💀 tiny dramatic reminder: the forced immediate shutdown is the fallback when the orderly shutdown fails. That's literally in the name, bestie.

🌈 SEE ALSO 🌈

The kernel file ./kernel/reboot.c is the home base for this whole friend group, and the squad is:

• emergency_restart(9)
• register_reboot_notifier(9)
• unregister_reboot_notifier(9)
• register_restart_handler(9)
• unregister_restart_handler(9)
• do_kernel_restart(9)
• kernel_restart(9)
• kernel_halt(9)
• register_sys_off_handler(9)
• unregister_sys_off_handler(9)
• devm_register_sys_off_handler(9)
• devm_register_power_off_handler(9)
• devm_register_restart_handler(9)
• register_platform_power_off(9)
• unregister_platform_power_off(9)
• do_kernel_power_off(9)
• kernel_can_power_off(9)
• kernel_power_off(9)
• orderly_reboot(9)
• hw_failure_emergency_action_func(9)
• hw_failure_emergency_schedule(9)
• __hw_protection_trigger(9)

mwah 💋 source/version check: ./kernel; date: October 2026; page tag: orderly_poweroff(9). bye bestie, go reboot responsibly 🫶✨