xe_vma_userptr_check_repin(9)

💅 xe_vma_userptr_check_repin — like, the advisory repin check bestie 💅

okay so this is a page from the Kernel API Manual, and it's all about xe_vma_userptr_check_repin — yes that's a whole mouthful, i know, but stay with me 🫶

---

✨ NAME ✨

xe_vma_userptr_check_repin — the advisory check for whether a repin is needed 👀

---

🌸 SYNOPSIS 🌸

int xe_vma_userptr_check_repin (struct xe_userptr_vma *uvma );

literally just one function, one arg, int coming back at you 💖

---

🎀 ARGUMENTS 🎀

• uvma — the userptr vma in question, that's the whole vibe ✨

---

🦋 DESCRIPTION 🦋

okay so what this does: it checks whether the userptr vma has been invalidated since the last successful repin. that's it. that's the check 💅

the check is advisory only — meaning it's giving "hey bestie maybe look into this" and not "this is legally binding", y'know? 😭

the way that this matters: the function can be called without the vm->svm.gpusvm.notifier_lock held. iconic, lowkey convenient. but 🚨 there is no guarantee that the vma userptr will remain valid after a lockless check. so typically the call needs to be followed by a proper check under the notifier_lock. no cap, that second check is not optional in practice, so don't skip it 🙈

---

🔥 RETURN 🔥

• 0 — userptr vma is valid, we love to see it 👑
• -EAGAIN — otherwise; repin recommended. yeah. it's giving "go repin" 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_userptr.c — the source, go read it iykyk 🍓
• __xe_vm_userptr_needs_repin(9)
• xe_vma_userptr_force_invalidate(9)
• xe_vm_userptr_check_repin(9)

---

and that's the page!! mwah 💖 this little gem lives in ./drivers/gpu/drm/xe, dated October 2026, and it's titled xe_vma_userptr_check_repin(9) — go forth and repin responsibly, bestie 🧚✨🎀