__hw_protection_trigger(9)

💅 __hw_protection_trigger (a Kernel API Manual moment)

okay bestie, so this one lives in the Kernel API Manual (9 section, kernel-internals vibes ✨) and it's literally the "oh no the hardware is cooking, shut it down" function 🫶

✨ NAME ✨

__hw_protection_trigger — trigger an emergency system shutdown or reboot 🔥💀

🌸 SYNOPSIS 🌸

void __hw_protection_trigger (const char *reason , int ms_until_forced ,
enum hw_protection_action action );

that's the whole signature, no cap — void, so it doesn't hand you anything back 🎀

🦋 ARGUMENTS 🦋

• reason — the reason of the emergency shutdown or reboot, and yep it gets printed. so like, say something useful bestie 💖
• ms_until_forced — how long to wait for an orderly shutdown or reboot before triggering it. a negative value disables the forced shutdown or reboot entirely 🙈
• action — the hardware protection action to be taken, it's an enum hw_protection_action ⭐

👑 DESCRIPTION 👑

so the whole point: you initiate an emergency system shutdown or reboot to protect the hardware from further damage 💅 iconic protective behavior. usage examples include a thermal protection — i.e. things are getting toasty and we're bailing 🌡️🔥

💀 NOTE 💀

lowkey important: the request is ignored if a protection shutdown or reboot is already pending — even if the previous request gave a large timeout for forced shutdown/reboot. so multiple requests don't stack, periodt 🚫

🌈 SEE ALSO 🌈

Kernel file ./kernel/reboot.c and all these besties:

• 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_failure_emergency_schedule(9)

🎀 that's the page, bestie! it's from the ./kernel source tree and it's dated October 2026 — slay, go keep your hardware safe 💜🫶