intel_ggtt_restore_fences(9)

💅 intel_ggtt_restore_fences(9) — from the Kernel API Manual, bestie

okay so picture this: it's giving "put the fences back where you found them" energy. This page lives in the Kernel API Manual and it's about one lil function, intel_ggtt_restore_fences, whose whole personality is restore fence state. iconic, lowkey.

---

✨ NAME ✨

intel_ggtt_restore_fences — restore fence state 🎀

---

🦋 SYNOPSIS 🦋

void intel_ggtt_restore_fences (struct i915_ggtt *ggtt );

that's it. that's the whole signature. no cap. ✨

---

🌸 ARGUMENTS 🌸

• ggtt — the Global GTT. that's the one and only thing you hand it. 🫶

---

💖 DESCRIPTION 💖

so what does it actually do, you ask? it restores the hw fence state so it matches the software tracking again. like, the hardware and the software have to be on the same page, and this function is the one that gets them there. match made in heaven, fr fr. 💅

when do you call it? two moments, bestie:

1. after a GPU reset 🔥
2. on resume 😴➡️😳

and here's the caveat you cannot skip: on runtime suspend we only cancel the fences, and they get reacquired by the user later. so do not come for this function on runtime suspend expecting a restore — that is not the vibe. note it, remember it, live by it. 🧚

---

👑 SEE ALSO 👑

go read these next, iykyk:

• Kernel file ./drivers/gpu/drm/i915/gt/intel_ggtt_fencing.c fence register handling(9)
• i915_vma_revoke_fence(9)
• i915_vma_pin_fence(9)
• i915_reserve_fence(9)
• i915_unreserve_fence(9)
• tiling swizzling details(9)
• detect_bit_6_swizzle(9)
• i915_gem_object_do_bit_17_swizzle(9)
• i915_gem_object_save_bit_17_swizzle(9)

like literally a whole friend group of fence-related pages. go say hi. 🌈

---

⭐ reminder for the group chat: this page is about restoring after a GPU reset and on resume, and on runtime suspend it's cancel only — the user reacquires later. don't mix those up, bestie. 🙈

---

and that's the page!! mwah 💋 this one came from ./drivers/gpu/drm/i915/gt, dated October 2026, and it's still intel_ggtt_restore_fences(9) at the end of the day. slay, periodt. 🎀✨💜