xe_vma_resolve_pagemap(9)

💅 xe_vma_resolve_pagemap — from the Kernel API Manual, bestie 🫶

okay so this one is literally about answering the question "which pagemap does this VMA get??" and honestly? it's giving matchmaker energy ✨

---

✨ NAME ✨

xe_vma_resolve_pagemap — resolve the appropriate DRM pagemap for a VMA 💖

---

🌸 SYNOPSIS 🌸

struct drm_pagemap * xe_vma_resolve_pagemap (struct xe_vma *vma , struct
xe_tile *tile );

---

🎀 ARGUMENTS 🎀

• vma — pointer to the xe_vma structure, and it's the one holding the memory attributes 👑 like that's her whole job
• tile — pointer to the xe_tile structure, and it's used as the fallback for VRAM mapping 🦋 (the understudy, the safety net, the "if plan A ghosted us" option)

---

💜 DESCRIPTION 💜

so the whole point of this function is determining the correct DRM pagemap to use for a given VMA, periodt 🔥

here's the sequence, no cap:

1. first it checks whether a valid devmem_fd is provided in the VMA's preferred location 👀
2. if the devmem_fd is negative, it returns NULL — which means no pagemap is available, and smem is to be used as the preferred location 💀 (yes, that's the vibe: no pagemap, go to shared memory, it's fine, we move)
3. if the devmem_fd equals the default faulting GT identifier, it returns the VRAM pagemap associated with the tile ✨ slay, match made in heaven

and a lil peek into the future 🔮 — future support for multi-device configurations may use drm_pagemap_from_fd to resolve pagemaps from arbitrary file descriptors. that's not a thing yet, it's just the roadmap, iykyk 🧚

---

⭐ RETURN ⭐

a pointer to the resolved drm_pagemap 🎀 — or NULL if none is applicable. that's it, that's the answer, no crumbs left behind 🙈

---

🦋 SEE ALSO 🦋

kernel file ./drivers/gpu/drm/xe/xe_svm.c, plus drm_pagemap reference-counting in xe:(9) — and honestly the whole friend group showed up for this one:

• xe_svm_init(9)
• xe_svm_close(9)
• xe_svm_fini(9)
• xe_svm_range_validate(9)
• xe_svm_find_vma_start(9)
• xe_svm_range_needs_migrate_to_vram(9)
• xe_svm_handle_pagefault(9)
• xe_svm_has_mapping(9)
• xe_svm_unmap_address_range(9)
• xe_svm_bo_evict(9)
• xe_svm_range_find_or_insert(9)
• xe_svm_range_get_pages(9)
• xe_svm_ranges_zap_ptes_in_range(9)
• xe_svm_alloc_vram(9)
• xe_pagemap_create(9)
• xe_pagemap_find_or_create(9)
• xe_pagemap_shrinker_create(9)
• xe_pagemap_cache_create(9)
• xe_drm_pagemap_from_fd(9)
• xe_svm_flush(9)

---

and that's the whole page bestie 💅 mwah 💖

this icon lives in ./drivers/gpu/drm/xe, stamped October 2026, and it's filed under xe_vma_resolve_pagemap(9) — go off, you beautiful kernel doc 🌈✨