drm_gem_vram_vmap(9)

💖 drm_gem_vram_vmap(9) 💖

okay bestie, welcome to your Kernel API Manual moment ✨ this is the page for drm_gem_vram_vmap, and it's giving “pin it, map it, don't leave it pinned forever” energy 💅 iykyk.

---

🌸 NAME 🌸

drm_gem_vram_vmap — Pins and maps a GEM VRAM object into kernel address space 🦋

✨ SYNOPSIS ✨

int drm_gem_vram_vmap (struct drm_gem_vram_object *gbo , struct
       iosys_map *map );

🎀 ARGUMENTS 🎀

• gbo — the GEM VRAM object to map, bestie 💖
• map — returns the kernel virtual address of the VRAM GEM object's backing store 📍

💫 DESCRIPTION 💫

so the vmap function pins a GEM VRAM object to its current location — either system memory or video memory — and maps its buffer into kernel address space ✨ that's the whole main character move.

⚠️ but listen: a pinned object cannot be relocated, so you should avoid pinning objects permanently. no cap, that's important 💀

when you're done, call drm_gem_vram_vunmap with the returned address to unmap and unpin the GEM VRAM object 🫶

🌈 RETURN 🌈

0 on success, or a negative error code otherwise 👑

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/drm_gem_vram_helper.c overview(9)
• drm_gem_vram_create(9)
• drm_gem_vram_put(9)
• drm_gem_vram_offset(9)
• drm_gem_vram_vunmap(9)
• drm_gem_vram_fill_create_dumb(9)
• drm_gem_vram_object_free(9)
• drm_gem_vram_driver_dumb_create(9)
• drm_gem_vram_plane_helper_prepare_fb(9)
• drm_gem_vram_plane_helper_cleanup_fb(9)
• drm_gem_vram_object_vmap(9)
• drm_gem_vram_object_vunmap(9)
• drm_vram_mm_debugfs_init(9)
• drmm_vram_helper_init(9)
• drm_vram_helper_mode_valid(9)

---

okay that's the whole vibe check 💅 — source/version lives at ./drivers/gpu/drm, dated October 2026. bye bestie 🫶✨