drm_gem_for_...puvm_bo_safe(9)

💅 drm_gem_for_each_gpuvm_bo_safe(9) — the kernel API manual, bestie edition 🎀

okay so first things first: this is a page from the Kernel API Manual, and the function we're obsessing over today is drm_gem_for_each_gpuvm_bo_safe. Yes, the title up top is literally drm_gem_for_...puvm_bo_safe(9) because kernel manpage headers love to abbreviate, but we know her full name now. 💖

---

✨ NAME ✨

drm_gem_for_each_gpuvm_bo_safe — an iterator that safely walks over a list of &drm_gpuvm_bo. No cap, "safe" is the whole personality here. 🦋

---

🌸 SYNOPSIS 🌸

drm_gem_for_each_gpuvm_bo_safe (entry__ , next__ , obj__ );

Three args, all vibing in a row. Let's meet them 👇

---

🎀 ARGUMENTS 🎀

• entry__ — the drm_gpuvm_bo structure you assign to on every single iteration step. She's the main character of each loop pass. 👑
• next__ — stores the next drm_gpuvm_bo so you've always got the next step queued up. Girl is literally holding your place in line. 🙈
• obj__ — the drm_gem_object that the drm_gpuvm_bos you're walking are associated with. It's giving "these are my friends, actually." 🫶

---

💜 DESCRIPTION 💜

So here's the tea: this iterator walks over all the drm_gpuvm_bo structures associated with the drm_gem_object. All of them. Every last one. 🔥

And the way it does that? It's implemented with list_for_each_entry_safe — which, yeah, is why she's got "safe" right there in the name. That means it is safe against removal of elements. So go ahead and unlink stuff mid-walk, she's not gonna melt down over it. 😭💅

fr fr though, "safe" here means safe against removal — that's the specific promise. Don't go reading extra superpowers into it. ✨

---

🌈 SEE ALSO 🌈

Kernel file ./include/drm/drm_gem.h, plus the whole friend group:

• enum drm_gem_object_status(9)
• struct drm_gem_object_funcs(9)
• struct drm_gem_lru(9)
• struct drm_gem_object(9)
• DRM_GEM_FOPS(9)
• DEFINE_DRM_GEM_FOPS(9)
• drm_gem_get_huge_mnt(9)
• drm_gem_object_get(9)
• drm_gem_object_put(9)
• drm_gem_object_is_shared_for_memory_stats(9)
• drm_gem_is_imported(9)
• drm_gem_gpuva_init(9)
• drm_gem_for_each_gpuvm_bo(9)

---

and that's the page, bestie 🧚💖 she lives in ./include/drm, the source/version stamp on this one is October 2026, and the footer still reads drm_gem_for_...puvm_bo_safe(9) because the header never lets go of her ✨ iconic ✨ abbreviated name. slay, go read the header file, periodt. 🍓⭐