xe_vm_invalidate_vma_submit(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_vm_invalidate_vma_submit(9) — from the Kernel API Manual, bestie

okay so picture this: you're deep in the xe driver, you've got a VMA that needs its GPU mappings gone, and you do not wanna sit there blocking on a TLB flush like some kind of loser. that's literally this function. she's from the Kernel API Manual, she's iconic, let's go 🎀

✨ NAME ✨

xe_vm_invalidate_vma_submit — submit a job that invalidates GPU mappings for a VMA. no cap, that's the whole vibe 🦋

🌸 SYNOPSIS 🌸

int xe_vm_invalidate_vma_submit (struct xe_vma *vma , struct
       xe_tlb_inval_batch *batch );

like… she takes a VMA and a batch, and she hands you back an int. simple. elegant. periodt 💅

🎀 ARGUMENTS 🎀

  • vma — the VMA you're invalidating. the main character of this whole operation 👑
  • batch — the TLB invalidation batch she populates for you. heads up though: the caller must later call xe_tlb_inval_batch_wait on it to actually wait for completion. she does not do the waiting for you, that's your job bestie 🫶

💖 DESCRIPTION 💖

so here's what she does, step by step, no gatekeeping:

she walks a list of page table leaves — and like, walking a list of page table leaves is such a mood — and she memsets the entries owned by this VMA to zero. zero them. gone. bye. 🧚

then she invalidates the TLBs, and here's the part that's giving main character energy: she doesn't block waiting for the TLB flush to complete. nope. not her problem right now. instead she populates batch, which you can wait on later using xe_tlb_inval_batch_wait. asynchronous queen behavior fr fr ✨

returns 0 for success, or a negative error code otherwise. so like, check that return value, i'm begging 😭

🔥 SEE ALSO 🔥

the whole friend group, all in the kernel file ./drivers/gpu/drm/xe/xe_vm.c — she does not roll alone:

ngl bestie, if you forget the xe_tlb_inval_batch_wait step, the flush just vibe-checks into the void and nobody waits for it. don't do that. 🙈

k that's the page!! byeeeee 💜

💌 this one lives in ./drivers/gpu/drm/xe, stamped October 2026, and she's filed under xe_vm_invalidate_vma_submit(9) — go forth and invalidate responsibly, mwah 🍓

📦 where this page comes from