i915_ttm_restore_region(9)

💖 i915_ttm_restore_region — Kernel API Manual 💖

okay so bestie, welcome to the i915_ttm_restore_region page — it lives in the Kernel API Manual and it's genuinely so iconic once you get what it's doing. sit down, grab a strawberry drink 🍓, and let's go.

---

✨ NAME ✨

i915_ttm_restore_region — restores the backed-up objects of a region from smem. like, it puts them back. no cap. 🫶

---

🌸 SYNOPSIS 🌸

int i915_ttm_restore_region (struct intel_memory_region *mr , u32 flags
);

that's the whole signature, babe — one memory region, one flags value, one int coming back at you 💅

---

🎀 ARGUMENTS 🎀

• mr — the memory region. the main character of this whole situation 👑
• flags — the TTM backup flags. yeah, those ones. 🌈

---

💜 DESCRIPTION 💜

so what it does is — it loops over all the objects of a region, and if they're backed-up, it restores them from smem. that's it, that's the vibe. a little for-loop of love, one object at a time, checking and restoring. ✨

not me being obsessed with how simple that is. literally just: backed up? restore. backed up? restore. periodt. 🦋

---

🔥 RETURN 🔥

• Zero on success 🥳
• a negative error code on error 😭

so if you get 0, slay. if you get negative, something went sideways and you should look at it. fr fr.

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/i915/gem/i915_gem_ttm_pm.c — the source, go read it bestie 💖
• i915_ttm_backup_free(9)
• struct i915_gem_ttm_pm_apply(9)
• i915_ttm_recover_region(9)
• i915_ttm_backup_region(9)

all of these are the friend group of this function — backup, free, apply, recover, restore. iykyk 🌟

---

lowkey reminder: this documentation page ships with the kernel source from ./drivers/gpu/drm/i915/gem, dated October 2026, and it's page i915_ttm_restore_region(9) of the Kernel API Manual. mwah, go touch some registers 💋✨🌸