i915_request_wait_timeout(9)

💖 i915_request_wait_timeout(9) 💖

okay so bestie, welcome to the Kernel API Manual — we're in i915_request_wait_timeout land today and honestly? it's giving "patiently waiting for your group chat to reply" energy. sit down, hydrate, let's go ✨

---

🌸 NAME 🌸

i915_request_wait_timeout — wait until execution of request has finished 🫶

---

✨ SYNOPSIS ✨

long i915_request_wait_timeout (struct i915_request *rq , unsigned int
       flags , long timeout );

---

🎀 ARGUMENTS 🎀

• rq — the request to wait upon 💅 like, this is the main character, the thing we're staring at until it's done
• flags — how to wait 🦋 the vibe of your waiting, basically
• timeout — how long to wait in jiffies ⏳ not seconds, not vibes, jiffies, okay?

---

🌈 DESCRIPTION 🌈

i915_request_wait_timeout waits for the request to be completed, for a maximum of timeout jiffies — and yes, bestie, MAX_SCHEDULE_TIMEOUT implies an unbounded wait, i.e. "we'll be here forever, no cap" 😭

It returns the remaining time (in jiffies) if the request completed — which, plot twist, may be zero if the request is still unfinished after the timeout expires. Zero! Iconic but rude. 🫠

If the timeout is 0, it will return 1 if the fence is signaled. tiny little edge case, highkey important 👑

May return -EINTR is called with I915_WAIT_INTERRUPTIBLE and a signal is pending before the request completes 🚨 (yes, that's exactly how the original words it — -EINTR is, is called, we don't fix what we didn't break 💀)

---

⭐ NOTE ⭐

This function has the same wait semantics as dma-fence. so if you know her, you know this one — iykyk 🧚

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/i915/i915_request.c
• i915_request_active_engine(9)
• i915_request_free_capture_list(9)
• i915_request_await_deps(9)
• i915_request_await_object(9)
• i915_request_wait(9)

all the cousins, all slaying in their own lanes 🦋💜

---

💀 real talk reminder: -EINTR only shows up when you pass I915_WAIT_INTERRUPTIBLE and a signal is already pending before the request completes. that's the whole deal, no extras, periodt.

---

okay that's the page!! huge thank you to the source, which lives at ./drivers/gpu/drm/i915 and dated October 2026 — and the manual itself is i915_request_wait_timeout(9) in the Kernel API Manual. mwah, go touch grass, then come back and read the fence code 💖🎀✨