xe_pm_runtime_get(9)

💅 xe_pm_runtime_get(9)

okay bestie, so this is xe_pm_runtime_get(9) from the Kernel API Manual — yes, that Kernel API Manual, the one we all know and love 🫶. Let's get into it.

---

✨ NAME ✨

xe_pm_runtime_get — grab a runtime_pm reference AND resume synchronously. Two things at once, main character energy fr. 👑

---

🌸 SYNOPSIS 🌸

void xe_pm_runtime_get (struct xe_device *xe );

---

🎀 ARGUMENTS 🎀

• xe — the xe device instance. that's it. that's the argument. literally just the device. 💖

---

🦋 DESCRIPTION 🦋

So here's the tea: when it's possible, you should lowkey prefer scope-based runtime PM (that's the guard(xe_pm_runtime) vibe) over just calling this function directly. no cap.

Manual get/put handling? Only for two situations, and I need you to pay attention bestie:

• when the function contains goto-based logic which can break scope-based handling 😭 — yeah, gotos will do that, the scope-based stuff does not vibe with that
• or when the lifetime of the runtime PM reference does not match a specific scope — like, runtime PM obtained in one function and released in a different one. the reference is living its own life, honestly, iconic but also a whole thing 🙈

so like, if you can use guard(xe_pm_runtime) — do that. this function is the fallback, ngl.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_pm.c
• Xe Power Management(9)
• xe_pm_might_block_on_suspend(9)
• xe_pm_block_on_suspend(9)
• xe_rpm_reclaim_safe(9)
• xe_pm_suspend(9)
• xe_pm_resume(9)
• xe_pm_init_early(9)
• xe_pm_probe(9)
• xe_pm_init(9)
• xe_pm_fini(9)
• xe_pm_runtime_suspended(9)
• xe_pm_runtime_suspend(9)
• xe_pm_runtime_resume(9)
• xe_pm_runtime_put(9)
• xe_pm_runtime_get_ioctl(9)
• xe_pm_runtime_get_if_active(9)
• xe_pm_runtime_get_if_in_use(9)
• xe_pm_runtime_get_noresume(9)
• xe_pm_runtime_resume_and_get(9)
• xe_pm_assert_unbounded_bridge(9)
• xe_pm_set_vram_threshold(9)
• xe_pm_d3cold_allowed_toggle(9)
• xe_pm_module_init(9)

like, the whole friend group showed up for this one 💀 slay.

---

k bye bestie, go touch grass (or ./drivers/gpu/drm/xe, same thing) — this page came straight from ./drivers/gpu/drm/xe, dated October 2026, and it's the xe_pm_runtime_get(9) page from the Kernel API Manual. periodt. 💜✨