vmw_bo_map_and_cache(9)

✨ vmw_bo_map_and_cache ✨

okay so bestie, welcome to the Kernel API Manual — this little page is all about vmw_bo_map_and_cache(9), and honestly? it's a vibe. let's get into it 🫶

---

🌸 NAME 🌸

vmw_bo_map_and_cache — map a buffer object and cache the map 💅

---

🦋 SYNOPSIS 🦋

void * vmw_bo_map_and_cache (struct vmw_bo *vbo );

like, that's the whole signature, no cap ✨

---

🎀 ARGUMENTS 🎀

• vbo — the buffer object you wanna map. that's the one, that's the main character 👑

---

⭐ RETURN ⭐

it hands you back a kernel virtual address — or NULL if the mapping failed 😭 (so like, always check, ok? don't just rawdog it)

---

💜 DESCRIPTION 💜

so what this function actually does: it maps a buffer object into the kernel address space, or — if a map already exists — it just returns the virtual kernel address of that already existing map. efficient queen behavior, we love her 💅✨

the virtual address stays valid for as long as the buffer object is pinned or reserved. that's the deal, that's the contract 🤝

but the cached map gets torn down on any of these three things:

1. buffer object move
2. buffer object swapout
3. buffer object destruction

⚠️ like literally, if any of those three happen, your cached map is gone gone. don't be out here using a stale address, i'm begging 🙈

---

🔥 SEE ALSO 🔥

okay this is the whole friend group, gathered for you:

• kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_bo.c
• vmw_bo_free(9)
• vmw_bo_pin_in_placement(9)
• vmw_bo_pin_in_vram_or_gmr(9)
• vmw_bo_pin_in_vram(9)
• vmw_bo_pin_in_start_of_vram(9)
• vmw_bo_unpin(9)
• vmw_bo_get_guest_ptr(9)
• vmw_bo_pin_reserved(9)
• vmw_bo_unmap(9)
• vmw_bo_init(9)
• vmw_user_bo_synccpu_grab(9)
• vmw_user_bo_synccpu_release(9)
• vmw_user_bo_synccpu_ioctl(9)
• vmw_bo_unref_ioctl(9)
• vmw_user_bo_lookup(9)
• vmw_bo_fence_single(9)
• vmw_bo_swap_notify(9)
• vmw_bo_move_notify(9)

---

and that's the page!! 🎀 this lil gem lives in ./drivers/gpu/drm/vmwgfx and it's stamped October 2026 — go off, you icon 💖✨🦋 slay, periodt.