xe_drm_pagemap_from_fd(9)

💅 xe_drm_pagemap_from_fd(9) — like, the whole kernel API manual, bestie ✨

okay so real talk, this page lives in the Kernel API Manual and it's about one very specific little function. no cap, it's a short one, so let's get into it 🫶

---

🌸 NAME 🌸

xe_drm_pagemap_from_fd — hands you back a drm_pagemap pointer when you give it a (file_descriptor, region_instance) pair. that's the whole vibe 💫

---

✨ SYNOPSIS ✨

struct drm_pagemap * xe_drm_pagemap_from_fd (int fd , u32 region_instance );

like, you call it with two things and it gives you a struct drm_pagemap * back. iconic signature honestly 👑

---

🎀 ARGUMENTS 🎀

• fd — an fd opened against an xe device. yes bestie, an actual file descriptor, opened on an xe device. that's the requirement, don't come at it with anything else 🙈
• region_instance — the region instance, and it's a u32. it's the one representing the device memory on the opened xe device. so like, which memory region on that device. iykyk 💜

---

🦋 DESCRIPTION 🦋

this is where it does the thing: it opens a struct drm_pagemap pointer on the indicated device and region_instance. that's it, that's the function. lowkey elegant, highkey underrated. periodt 💅

---

🌈 RETURN 🌈

• on success 🎉 — you get a reference-counted struct drm_pagemap pointer. note the reference-counted part, it's giving "you own a reference now, act like it" energy.
• on failure 😭 — you get a negative error pointer. classic kernel move, so check that thing with your error-checking macros, okay? don't be out here dereferencing it fr fr 💀

---

⭐ SEE ALSO ⭐

the whole friend group, no one left out 🫶:

• Kernel file ./drivers/gpu/drm/xe/xe_svm.c
• drm_pagemap reference-counting in xe:(9)
• 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_svm_flush(9)

---

go read them, bestie, they're all literally right there in the same directory 🧚‍♀️

---

and that's the tea ☕ this one's brought to you by source ./drivers/gpu/drm/xe, dated October 2026 — mwah, xoxo, go get that pagemap 🍓💖