xe_preempt_fence_alloc(9)

✨ xe_preempt_fence_alloc(9) ✨

okay so, bestie, welcome to the Kernel API Manual — this page is xe_preempt_fence_alloc(9), and it's giving “tiny allocator with big responsibilities” energy 🎀

🌸 NAME 🌸

xe_preempt_fence_alloc — allocate a preempt fence with minimal initialization. That's the whole assignment: make the fence, keep the setup tiny 💅

🦋 SYNOPSIS 🦋

the signature is literally this, no cap:

struct xe_preempt_fence * xe_preempt_fence_alloc (void );

🎀 ARGUMENTS 🎀

• void — no arguments. not a single one. the void ate and left no crumbs 🫶

💖 DESCRIPTION 💖

So this one allocates a preempt fence, and initializes its list head. That's the “minimal initialization” vibe — it's not doing a whole main-character backstory for you.

⚠️ bestie, this part is important: if the preempt_fence you allocated has been armed with xe_preempt_fence_arm, it must be freed using dma_fence_put. If it has not been armed, it must be freed using xe_preempt_fence_free. Do not mix those up, fr fr 😭

🔥 RETURN 🔥

A struct xe_preempt_fence pointer used for calling into xe_preempt_fence_arm or xe_preempt_fence_free. An error pointer on error. periodt 💀

👑 SEE ALSO 👑

• Kernel file — ./drivers/gpu/drm/xe/xe_preempt_fence.c
• xe_preempt_fence_free(9)
• xe_preempt_fence_arm(9)
• xe_preempt_fence_create(9)

mwah 🎀 signing off from source/version ./drivers/gpu/drm/xe, dated October 2026 — xe_preempt_fence_alloc(9), out 💜