hw_failure_...ncy_schedule(9)
π hw_failure_emergency_schedule β Kernel API Manual β¨
okay bestie so we're deep in the kernel API manual today and the page we're on is hw_failure_...ncy_schedule(9) β yes the title is literally abbreviated with dots in the middle, that's just how the header rolls, it's giving truncated-slash-iconic π
πΈ NAME πΈ
hw_failure_emergency_schedule β schedule an emergency system shutdown or reboot π¨π
β¨ SYNOPSIS β¨
void hw_failure_emergency_schedule (enum hw_protection_action action ,
int action_delay_ms );
like, that's the whole vibe. void, so it doesn't hand you anything back. it just does the thing. π
π«Ά ARGUMENTS π«Ά
actionβ the hardware protection action that's gonna get taken. this is the main character of the whole call ngl.action_delay_msβ the time in milliseconds to elapse before the action gets triggered. so it's not instant, it's fashionably late by exactly however many ms you told it. β³
π¦ DESCRIPTION π¦
so the way this works is: you can call this from literally any critical situation and it'll trigger a system shutdown or reboot after a given period of time. no cap. emergency hours fr fr.
and here's the little plot twist π β if time is negative this is not scheduled. that's it. negative delay = nothing happens. the vibe check fails, the schedule does not get made. periodt.
β οΈ bestie this one is for critical situations only β the manual says so directly, and we do not editorialise. it's an emergency shutdown/reboot scheduler, not a toy. π
π₯ SEE ALSO π₯
the kernel file ./kernel/reboot.c is the mothership, and she has a whole friend group:
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_poweroff(9)orderly_reboot(9)hw_failure_emergency_action_func(9)__hw_protection_trigger(9)
like, that's the whole reboot/poweroff extended universe. iykyk πβ
and that's the page!! π mwah π
so this little beauty lives in ./kernel, dated October 2026 β source and version, cute sign-off, bye bestie, go schedule your emergency shutdown responsibly π¦π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms