xe_pagemap_create(9)

💖 NAME 💖

okay so bestie, welcome to the xe_pagemap_create(9) page in the Kernel API Manual — this one is literally about xe_pagemap_create, and its whole job is to create a struct xe_pagemap object ✨.

🌸 SYNOPSIS 🌸

struct xe_pagemap * xe_pagemap_create (struct xe_device *xe , struct xe_vram_region *vr );

🎀 ARGUMENTS 🎀

• xe — the xe device. main character device energy 💅
• vr — back-pointer to the struct xe_vram_region. it's giving "remember where u came from" 🦋

✨ DESCRIPTION ✨

so this function allocates and initializes a struct xe_pagemap — yes, both, she does it all 💖.

on a successful return, bestie, u should use drm_pagemap_put on the embedded struct drm_pagemap to unreference it. that's the cleanup step, don't forget it 🙈.

🔥 RETURN 🔥

if it works, u get a pointer to a struct xe_pagemap — slay ✅. if it fails, u get an error pointer 😭. that's the whole vibe check.

🌈 SEE ALSO 🌈

okay the Kernel file is ./drivers/gpu/drm/xe/xe_svm.c, and there's also drm_pagemap reference-counting in xe:(9) — plus this whole friend group of references, periodt:

• 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_find_or_create(9)
• xe_pagemap_shrinker_create(9)
• xe_pagemap_cache_create(9)
• xe_drm_pagemap_from_fd(9)
• xe_svm_flush(9)

mwah 💋 this page lives under ./drivers/gpu/drm/xe, dated October 2026, and the manual name is xe_pagemap_create(9) — bye bestie 🫶