xe_vm_create_scratch(9)

oi bestie 💖 welcome to the xe_vm_create_scratch(9) page in the Kernel API Manual. This one is lowkey specific and highkey useful, so grab your iced coffee and let’s get into it ✨

NAME 🎀

xe_vm_create_scratch — setup a scratch memory pagetable tree for the given tile and vm. That’s the whole assignment, no cap 💅

SYNOPSIS ✨

int xe_vm_create_scratch (struct xe_device *xe , struct xe_tile *tile ,
       struct xe_vm *vm , struct drm_exec *exec );

ARGUMENTS 🫶

• xe — xe device. The main character device in this situation 👑
• tile — tile to set up for. The tile bestie we’re doing this for 💫
• vm — vm to set up for. The vm getting the scratch treatment 🧚
• exec — the struct drm_exec object used to lock the vm resv. It’s giving “lock situation, but make it official” 🔐

DESCRIPTION 🦋

okay so here’s the vibe: it sets up a pagetable tree with one page-table per level and a single leaf PTE. Literally that. 🌸

All pagetable entries point to the single page-table or, for MAX_HUGEPTE_LEVEL, a NULL huge PTE returning 0 on read and writes become NOPs. Periodt. 💅

RETURN 🌈

0 on success, negative error code on error. Simple, iconic, no plot twist 😌

SEE ALSO 💜

• Kernel file ./drivers/gpu/drm/xe/xe_vm.c
• xe_vm_drm_exec_lock(9)
• xe_vm_remove_compute_exec_queue(9)
• xe_vm_kill(9)
• xe_vm_validate_rebind(9)
• xe_vm_bump_lru(9)
• xe_vm_resume_rebind_worker(9)
• xe_vm_add_fault_entry_pf(9)
• xe_vm_range_rebind(9)
• xe_vm_range_unbind(9)
• xe_vma_mem_attr_copy(9)
• xe_vm_lock_vma(9)
• xe_vm_find_vma_by_addr(9)
• xe_vma_has_default_mem_attrs(9)
• struct xe_vma_lock_and_validate_flags(9)
• xe_vm_bind_kernel_bo(9)
• xe_vm_lock(9)
• xe_vm_unlock(9)
• xe_vm_invalidate_vma_submit(9)
• xe_vm_invalidate_vma(9)
• xe_vma_need_vram_for_atomic(9)
• xe_vm_alloc_madvise_vma(9)
• xe_vm_find_cpu_addr_mirror_vma_range(9)
• xe_vm_alloc_cpu_addr_mirror_vma(9)
• xe_vm_add_exec_queue(9)
• xe_vm_remove_exec_queue(9)

and that’s the page, bestie 🫶 source/version: ./drivers/gpu/drm/xe, date: October 2026, page: xe_vm_create_scratch(9). bye mwah 💋