DRM_PAGEMAP REFERENCE-COUNTING IN XE:(9)

💅 drm_pagemap reference-counting in xe:(9) 💅

okay bestie, this one's straight out of the Kernel API Manual and it's literally all about who's holding a reference to what, so nobody's memory gets freed while it's still main character energy 👑

So here's the tea ☕: the drm_pagemap already does its own internal reference counting through its zone device data — that part's handled, no notes. But on top of that, the xe driver is out here holding the following long-time references, and you need to know about every single one 🫶

• struct xe_pagemap — the xe_pagemap struct derives from struct drm_pagemap and just uses its reference count. Iconic inheritance moment, no cap ✨
• SVM-enabled VMs — SVM-enabled VMs look up all the xe_pagemaps on the same device and keep a reference to them. Obsessed with the loyalty fr fr 💖
• VMAs — vmas keep a reference on the drm_pagemap indicated by a gpu_madvise call. That's the whole vibe 🌸

And lowkey the big one 👀: in addition, all drm_pagemap or xe_pagemap pointers where the lifetime cannot be guaranteed by a vma reference under the vm lock should keep a reference. That includes the range->pages.dpagemap pointer — yes, that one too, don't skip it bestie, it's giving "tiny detail that will absolutely wreck your day if you ignore it" 💀

🚨 reminder: "cannot be guaranteed by a vma reference under the vm lock" means keep a reference. Not a suggestion, it's a vibe check you have to pass 💅

✨ SEE ALSO ✨

Kernel file ./drivers/gpu/drm/xe/xe_svm.c plus this whole friend group of functions — go say hi, they're all linked together for a reason 🦋

• 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_vma_resolve_pagemap(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)

okay that's the whole page, you ate that 🍓 this came from ./drivers/gpu/drm/xe and it's dated October 2026 — go forth and please keep your references alive, mwah 💜🧚