__intel_wait_for_register(9)

💅 __intel_wait_for_register 💅

okay so this is a page straight out of the Kernel API Manual, and honestly? it's a whole vibe. it's called __intel_wait_for_register and it does exactly one thing: it waits until a register matches the state you expect. patient queen behavior fr fr 🎀

---

✨ SYNOPSIS ✨

int __intel_wait_for_register (struct intel_uncore *uncore , i915_reg_t
reg , u32 mask , u32 value , unsigned int fast_timeout_us , unsigned int
slow_timeout_ms , u32 *out_value );

like, look at all those parameters bestie. she's got range. 💅

---

🦋 ARGUMENTS 🦋

• uncore — the struct intel_uncore. this is the main character, the context you're working inside of ✨
• reg — the register to read. the spot you're keeping your eyes on 👀
• mask — mask to apply to register value. you're filtering, we love a filter 🎀
• value — expected value. the thing you're manifesting 🌸
• fast_timeout_us — fast timeout in microsecond for atomic/tight wait. yes, microsecond, singular, that's what the manpage says, don't come for me 😭 that's the quick lil tight-loop energy, highkey impatient 🔥
• slow_timeout_ms — slow timeout in millisecond. the chill, patient one. give it a sec 🧚
• out_value — optional placeholder to hold registry value. optional!! she doesn't have to be there, but if she is, she's holding the goods 💖

---

💜 DESCRIPTION 💜

so basically this routine waits until the target register reg contains the expected value after applying the mask. like, it's literally standing there refreshing until the vibes check out. it waits until:

(intel_uncore_read(uncore, reg) & mask) == value

and if that never happens? the wait will timeout after timeout_ms milliseconds. no cap, it's not gonna wait forever for you bestie 💀

---

🌈 RETURN 🌈

• 0 if the register matches the desired condition — slay, you got it 👑
• or -ETIMEDOUT — the "she never texted back" of return values 😭

---

🔥 SEE ALSO 🔥

the source lives in the kernel file at ./drivers/gpu/drm/i915/intel_uncore.c — go read her, she ate 📖

and here's the whole friend group, all of them absolutely iconic:

• intel_uncore_forcewake_get(9)
• intel_uncore_forcewake_user_get(9)
• intel_uncore_forcewake_user_put(9)
• intel_uncore_forcewake_get__locked(9)
• intel_uncore_forcewake_put(9)
• intel_uncore_forcewake_flush(9)
• intel_uncore_forcewake_put__locked(9)
• __intel_wait_for_register_fw(9)
• intel_uncore_forcewake_for_reg(9)

---

okay that's the whole page!! 🫶 this little gem lives over in ./drivers/gpu/drm/i915 and the manual itself is dated October 2026, so she's from the future, main character energy only ⭐ byeee bestie, go wait on that register 💖✨🍓