touch_nmi_watchdog(9)
π touch_nmi_watchdog β kernel API manual, section 9, bestie π
okay so bestie, welcome to touch_nmi_watchdog(9) from the Kernel API Manual β yes we're in the kernel, yes it's giving main character energy, and yes i'm gonna explain the whole thing to you. no cap. π¦
β¨ NAME β¨
touch_nmi_watchdog β manually reset the hardlockup watchdog timeout. that's it. that's the whole vibe. she pets the watchdog, periodt. ππ
β¨ SYNOPSIS β¨
void touch_nmi_watchdog (void );
literally the entire signature. nothing in, nothing out. clean. iconic. π
β¨ ARGUMENTS β¨
voidβ no arguments. zero. none. she takes nothing from you, she just resets things. π«Ά
β¨ DESCRIPTION β¨
so here's the tea β β if we support detecting hardlockups, touch_nmi_watchdog may be used to pet the watchdog (aka reset the timeout). it's for code that intentionally disables interrupts for a long time and needs the watchdog to not freak out about it. think of it as like, "hey girl i know i'm being quiet rn but i promise i'm not dead, don't restart me bestie π" β and that's literally the whole point.
also important: this call is stateless. no memory, no bookkeeping, no nothing. you touch it, it resets, done. she does not hold a grudge, she does not remember you, she simply vibes. β¨
now for the little plot twist π β even though this function has "nmi" in the name, the hardlockup watchdog might not be backed by NMIs at all. so the name is lowkey misleading?? anyway, the word on the street is that this function will likely be renamed to touch_hardlockup_watchdog in the future. so don't get too attached to the current name, it's giving glow-up incoming π
π₯
ngl the naming drama is real but the behavior is stable, so you're fine. just, y'know. iykyk. π
β¨ SEE ALSO β¨
- Kernel file
./include/linux/nmi.hβ go read her, she's the source of truth π§π
and that's the page bestie!! πΈ this one lives in ./include/linux, dated October 2026, and she answers to the name touch_nmi_watchdog(9) β so like, if anyone asks, that's her full government name ππ mwah, go pet that watchdog 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