xe_tlb_inval_job_put(9)

💅 xe_tlb_inval_job_put(9) — the kernel API manual, bestie edition

okay so you're in the kernel API manual section 9, and today's main character is xe_tlb_inval_job_put. she lives in the xe DRM driver and honestly? she's a small function with big "i just handle the refcount" energy. let's get into it 🫶

---

✨ NAME ✨

xe_tlb_inval_job_put — put a reference to a TLB invalidation job. that's it, that's the whole vibe. literally just dropping a ref 💅

---

🌸 SYNOPSIS 🌸

void xe_tlb_inval_job_put (struct xe_tlb_inval_job *job );

returns nothing (void), takes one pointer, slays quietly ✨

---

🎀 ARGUMENTS 🎀

• job — the TLB invalidation job object. that's your girl. the thing you're putting a reference to 🦋

---

💖 DESCRIPTION 💖

so here's the tea, bestie: this function decrements the TLB invalidation job's reference count. that's the whole job (pun intended lmao) 🔥

and when that reference count hits 0? it calls xe_tlb_inval_job_destroy. like, she saw the count drop to zero and immediately knew what to do. iconic behavior tbh 👑

but wait, there's a little guard clause lore 🙈 — it skips the decrement if the input job is NULL or is IS_ERR. so if somebody hands you a null pointer or an error pointer, you just... don't. no decrementing, no drama, we move on 💀

ngl this is the "check your input before you touch the refcount" moment and honestly more code should do this

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/xe/xe_tlb_inval_job.c — go read the source, iykyk 📖
• xe_tlb_inval_job_create(9) — the one who makes the job in the first place 👶
• xe_tlb_inval_job_add_page_reclaim(9)
• xe_tlb_inval_job_alloc_dep(9)
• xe_tlb_inval_job_push(9)
• xe_tlb_inval_job_get(9) — the opposite energy, she takes a reference 🌈

---

💀 friendly reminder: put and get are a matched set, bestie. don't be out here putting refs you never got. that's giving undefined behavior and we don't do that here

---

okay that's the whole page!! this one came from ./drivers/gpu/drm/xe, dated October 2026, and the manual is the Kernel API Manual, section 9, title xe_tlb_inval_job_put. periodt 💅🎀✨