pm_runtime_get_if_active(9)

💖 pm_runtime_get_if_active(9) 💖

okay so this is the Kernel API Manual, bestie — and today’s main character is pm_runtime_get_if_active. yes, the title is right there, and the manual name is folded in like a little name tag. Let’s go. ✨

✨ NAME ✨

pm_runtime_get_if_active — bump up the runtime PM usage counter if the device is in active state. periodt.

🌸 SYNOPSIS 🌸

here’s the exact signature, no cap — keep it verbatim:

int pm_runtime_get_if_active (struct device *dev );

🎀 ARGUMENTS 🎀

• dev — target device. that’s the whole argument, bestie.

💅 DESCRIPTION 💅

okay so here’s the tea. This function increments the runtime PM usage counter of dev if its runtime PM status is RPM_ACTIVE — and in that case it returns 1. slay.

If the device is in a different state, 0 is returned. no bump, no drama.

And if runtime PM is disabled for the device, -EINVAL is returned — and in that case the usage_count will also remain unmodified. so no sneaky counter changes, okay?

heads up: that -EINVAL case means runtime PM is disabled for the device, and the usage_count stays unmodified. iykyk.

🦋 SEE ALSO 🦋

okay bestie, the related-lore rabbit hole is deep. Go read these:

• Kernel file ./drivers/base/power/runtime.c
• update_pm_runtime_accounting(9)
• pm_runtime_deactivate_timer(9)
• pm_runtime_cancel_pending(9)
• rpm_check_suspend_allowed(9)
• pm_runtime_release_supplier(9)
• __rpm_callback(9)
• rpm_callback(9)
• rpm_idle(9)
• rpm_suspend(9)
• rpm_resume(9)
• pm_runtime_work(9)
• pm_suspend_timer_fn(9)
• pm_schedule_suspend(9)
• __pm_runtime_idle(9)
• __pm_runtime_suspend(9)
• __pm_runtime_resume(9)
• pm_runtime_get_conditional(9)
• pm_runtime_get_if_in_use(9)
• __pm_runtime_set_status(9)
• __pm_runtime_barrier(9)
• pm_runtime_barrier(9)
• pm_runtime_enable(9)
• devm_pm_runtime_set_active_enabled(9)
• devm_pm_runtime_enable(9)
• devm_pm_runtime_get_noresume(9)
• pm_runtime_forbid(9)
• pm_runtime_allow(9)
• pm_runtime_no_callbacks(9)
• pm_runtime_irq_safe(9)
• update_autosuspend(9)
• pm_runtime_set_autosuspend_delay(9)
• __pm_runtime_use_autosuspend(9)
• pm_runtime_init(9)
• pm_runtime_reinit(9)
• pm_runtime_remove(9)
• pm_runtime_get_suppliers(9)
• pm_runtime_put_suppliers(9)
• pm_runtime_drop_link(9)
• pm_runtime_force_suspend(9)
• pm_runtime_force_resume(9)

---

that’s the whole vibe, bestie. this page is from the source/version ./drivers/base/power, dated October 2026, and it’s pm_runtime_get_if_active(9) from the Kernel API Manual. byeee, go bump those counters responsibly 💖