xe_vm_clear_validating(9)

✨ xe_vm_clear_validating(9) ✨

okay so bestie, welcome to the Kernel API Manual 💅 this one's a little kernel function called xe_vm_clear_validating(9) and it's giving "small function, big responsibilities" energy, ngl.

🎀 NAME 🎀

xe_vm_clear_validating — unregister this task as currently making bos resident 🫶

🌸 SYNOPSIS 🌸

void xe_vm_clear_validating (struct xe_vm *vm , bool allow_res_evict );

🦋 ARGUMENTS 🦋

• vm — pointer to the vm, or NULL (yes, NULL is allowed, she's flexible like that 💁‍♀️)
• allow_res_evict — eviction from vm was allowed. Must be set to the same value as for xe_vm_set_validation. like, must must, no cap, don't be out here freelancing with a different value 🔥

👑 DESCRIPTION 👑

So the DESCRIPTION says: register this task as currently making bos resident for the vm ✨. It's intended to avoid eviction by the same task of shared bos bound to the vm — basically it's the "hey, this is my stuff, don't touch it" note you leave for yourself so you don't accidentally evict your own things 😭.

And the crucial bit: call with the vm's resv lock held 🔒 periodt. If you're not holding it, you're not doing it right, and that's the whole vibe check.

💀 tiny heads-up bestie: the NAME section up there says unregister, and the DESCRIPTION says register. I'm not gonna smooth that over for you — that's literally what the page says, I'm just the messenger 🙈 read it however the source does, iykyk.

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/xe/xe_vm.h and honestly the whole friend group:

• MAX_FAULTS_SAVED_PER_VM(9) 💖
• xe_vm_has_scratch(9)
• gpuvm_to_vm(9)
• Provide accessors for vma members to facilitate easy change of(9) (yes that's the whole name, iconic honestly 👑)
• to_userptr_vma(9)
• xe_vm_reactivate_rebind(9)
• xe_vm_resv(9)
• xe_vm_assert_held(9)
• xe_vm_set_validating(9)
• xe_vm_is_validating(9)
• xe_vm_set_validation_exec(9)
• xe_vm_validation_exec(9)
• xe_vm_has_valid_gpu_mapping(9)

aaaand that's the page!! 🎀 she lives in ./drivers/gpu/drm/xe, dated October 2026, and goes by xe_vm_clear_validating(9) — go forth and clear those validatings responsibly bestie, lock held, matching allow_res_evict value, slay 💜✨