pm_runtime_force_suspend(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… pm_runtime_force_suspend(9) πŸ’…

Kernel API Manual β€” yes bestie, that's the manual name, and we're folding it in right here at the top. 🫢

πŸŽ€ NAME πŸŽ€

pm_runtime_force_suspend β€” Force a device into suspend state if needed. periodt.

✨ SYNOPSIS ✨

int pm_runtime_force_suspend (struct device *dev );

πŸ¦‹ ARGUMENTS πŸ¦‹

  • dev β€” Device to suspend. That's the main character right there.

πŸ”₯ DESCRIPTION πŸ”₯

Okay so here's the tea: this disables runtime PM so we can safely check the device's runtime PM status. If it's active, it invokes its ->runtime_suspend callback to suspend it and changes its runtime PM status field to RPM_SUSPENDED. Slay. ✨

Also, if the device's usage and children counters don't indicate that the device was in use before the system-wide transition under way, it decrements its parent's children counter (if there is a parent). Keep runtime PM disabled to preserve the state unless we encounter errors. No cap, that part matters.

Typically this function may be invoked from a system suspend callback to make sure the device is put into low power state, and it should only be used during system-wide PM transitions to sleep states. It assumes that the analogous pm_runtime_force_resume will be used to resume the device. Lowkey iconic teamwork. πŸ’–

🌈 SEE ALSO 🌈


πŸ’œ That's the vibe check, bestie β€” this page is from ./drivers/base/power and dated October 2026. 🫢

πŸ“¦ where this page comes from