intel_wakeref_wait_for_idle(9)

📦 version 7.3.1, in nixpkgs unstable

💤 intel_wakeref_wait_for_idle(9) — the Kernel API Manual page you didn't know you needed

okay so bestie, welcome to the glow-up of intel_wakeref_wait_for_idle(9), straight out of the Kernel API Manual. yes, that manual. we're in the i915 corner of the kernel and it's giving "please just let the GPU rest" energy, and honestly? same. 🦋

✨ NAME ✨

intel_wakeref_wait_for_idle — wait until the wakeref is idle. that's it. that's the whole vibe. you wait, it goes idle, everyone's happy. 💅

🌸 SYNOPSIS 🌸

int intel_wakeref_wait_for_idle (struct intel_wakeref *wf );

like, you hand it a wakeref pointer and it hands you back an int. iconic exchange. 🤝

🎀 ARGUMENTS 🎀

  • wf — the wakeref. yeah. that's the one. the wakeref in question. the main character. 👑

🧚 DESCRIPTION 🧚

so here's the thing, bestie: wakerefs can get released asynchronously — like, later, on their own time, no text back 😭 — and this function is literally just you standing there waiting for that earlier async release to actually go through. patient queen behavior.

but — and this is the part where you need to listen — it will also wait on any third party too. not just you. anybody. so pls pls pls make sure you only ever wait when:

  • you actually have control over the wakeref, and
  • you trust that no one else is acquiring it
fr fr, if some other code is out here grabbing that wakeref while you're waiting, you're gonna have a bad time. trust no one. 🙈

⭐ RETURN ⭐

  • 0 on success 💖
  • an error code if killed 💀

🔥 SEE ALSO 🔥

Kernel file ./drivers/gpu/drm/i915/intel_wakeref.h, and the whole friend group:

and that's the page!! 💜 brought to you by ./drivers/gpu/drm/i915, dated October 2026, and titled — say it with me — intel_wakeref_wait_for_idle(9). mwah, go wait on that wakeref responsibly, bestie 🫶✨🍓

📦 where this page comes from