pm_runtime_forbid(9)

📦 version 7.3.1, in nixpkgs unstable

💅 pm_runtime_forbid(9) — like, the kernel API manual bestie ✨

okay so real quick before we dive in: this is a page from the Kernel API Manual, and the star of the show is pm_runtime_forbid(9). yes that's the whole title. she's a function. she's iconic. let's go 🎀

🌸 NAME 🌸

pm_runtime_forbid — block runtime PM of a device. that's it. that's the vibe. a little bouncer for your device's power management, and she is NOT letting anyone in 💅

✨ SYNOPSIS ✨

void pm_runtime_forbid (struct device *dev );

literally one argument. one. we love a low-maintenance queen 🫶

🧚 ARGUMENTS 🧚

  • dev — the device you're handling. like, the one you're about to put in timeout. just hand her over and let the function do its thing 💖

👑 DESCRIPTION 👑

okay so here's the tea, bestie 🍓

pm_runtime_forbid resumes dev if it's already suspended — yes, she wakes it up first, respectfully — and then blocks runtime suspend of dev. so the device can't just yeet itself into a low-power nap whenever it feels like it.

and here's the cute part: this block is unblockable in a very specific way. you can undo it via the /sys/devices/.../power/control interface, or otherwise by calling pm_runtime_allow. two doors out. pick one 🚪✨

lowkey important: calling this function many times in a row has the same effect as calling it once. so like, spamming it does nothing extra. no stacking, no combo multiplier, no cap. she's idempotent and she knows it 💀

🦋 SEE ALSO 🦋

the whole squad, fr fr. every single one of these:

like I said. the whole squad. screenshot it, memorize it, whatever 😭🔥

and that's the page, bestie!! this little number lives in ./drivers/base/power and it's dated October 2026 — so she's from the future, of course she is 💜✨ go forth and forbid some runtime PM, iykyk 🌈👑

📦 where this page comes from