for_each_ggtt_vma(9)

💖 for_each_ggtt_vma(9) — Kernel API Manual 💖

okay so bestie, welcome to the for_each_ggtt_vma(9) page, straight out of the Kernel API Manual ✨ this one is short and sweet and honestly kind of iconic for it.

---

✨ NAME ✨

for_each_ggtt_vma — iterate over the GGTT VMA belonging to an object. that's it. that's the whole job 🫶

---

🌸 SYNOPSIS 🌸

for_each_ggtt_vma (V , OBJ );

---

🎀 ARGUMENTS 🎀

• V — the #i915_vma iterator 💫 this is your little cursor, your main character walking the list
• OBJ — the #drm_i915_gem_object 👑 the object whose VMAs we're out here iterating, no cap

---

🦋 DESCRIPTION 🦋

so here's the tea, and it's actually such a clean design choice:

GGTT VMAs are placed at the beginning of the object's vma_list — see vma_create — so we can stop our walk as soon as we see a ppgtt VMA. or, y'know, when the list is empty, ofc 💅

that's literally it. the ordering is doing all the work for us and honestly? we stan an early exit 🔥

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/i915/i915_vma.h, plus the whole friend group:

• i915_vma_size(9)
• i915_vma_offset(9)
• i915_vma_pin_iomap(9)
• i915_vma_unpin_iomap(9)
• i915_vma_pin_fence(9)
• i915_vma_unpin_fence(9)
• i915_vma_get_current_resource(9)

---

and that's the page, bestie!! 🧚 source/version is ./drivers/gpu/drm/i915 and the date on this cutie is October 2026 — go forth and iterate responsibly 💜🌸🎀