i915_ttm_backup_region(9)

💅 i915_ttm_backup_region(9) — the Kernel API Manual, bestie edition ✨

okay so this is a page from the Kernel API Manual and it's all about i915_ttm_backup_region — one little function, and honestly? it's giving "quietly doing the most". 🌸

---

🎀 NAME 🎀

i915_ttm_backup_region — back up all the objects of a region to smem. like, all of them. every last one. no cap. 💖

---

🦋 SYNOPSIS 🦋

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

that's the whole signature, copied verbatim because we do not play with code around here ✨

---

🍓 ARGUMENTS 🍓

• mr — the memory region 👑 this is the region our main character is working with.
• flags — TTM backup flags 🚩 the little switches that tell the backup how to behave.

---

🌈 DESCRIPTION 🌈

okay so picture this: the function literally loops over all the objects of a region, and then it makes a call on each one, bestie-style. 🔥

• if an object is evictable, it evicts it. bye babe 👋
• if an object is pinned, it backs it up using a backup object. secure the bag 💅

that's the vibe check: evict the evictable, back up the pinned. periodt.

---

⭐ RETURN ⭐

• Zero on success 🎉 (iconic, flawless)
• a negative error code on error 😭 (it happens to the best of us)

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/i915/gem/i915_gem_ttm_pm.c 📁
• i915_ttm_backup_free(9)
• struct i915_gem_ttm_pm_apply(9)
• i915_ttm_recover_region(9)
• i915_ttm_restore_region(9)

all the related lore, iykyk 🫶

---

ngl if you're reading this page you're already deep in the i915 gem/ttm trenches and honestly? respect. 💜

---

and that's a wrap, bestie 🎀 this little page dropped in October 2026, lives under ./drivers/gpu/drm/i915/gem, and it's serving Kernel API Manual energy from the first line to the last. mwah 💋✨