xe_preempt_fence_arm(9)

💅 xe_preempt_fence_arm(9)

okay bestie, welcome to the Kernel API Manual — this one's a (9) section situation, aka kernel internals territory, and honestly it's kind of a serve once you get what it does 🎀

✨ NAME ✨

xe_preempt_fence_arm — arm a preempt fence that was allocated using xe_preempt_fence_alloc(). like, you already made the fence, now you gotta actually arm it. no cap, that's the whole vibe check 💅

🦋 SYNOPSIS 🦋

struct dma_fence * xe_preempt_fence_arm (struct xe_preempt_fence *pfence
, struct xe_exec_queue *q , u64 context , u32 seqno );

yep, that's the whole signature, character for character, don't come for me 😭

🌸 ARGUMENTS 🌸

• pfence — the struct xe_preempt_fence pointer you got back from xe_preempt_fence_alloc. like, the original handoff. don't lose it 🙈
• q — the struct xe_exec_queue that's being used for arming. main character of this call, honestly.
• context — the dma-fence context used for arming. this is where the timeline lives 🕰️
• seqno — the dma-fence seqno used for arming. the little number that slots you into the timeline ✨

🔥 DESCRIPTION 🔥

so here's what's actually going down: this function inserts the preempt fence into context's timeline, takes link off any list, and registers the struct xe_exec_queue as the xe_engine to be preempted.

three things. all at once. it's giving multitasking icon behavior, honestly 👑

💖 RETURN 💖

it hands you back a pointer to a struct dma_fence that's embedded into the preempt fence. and the best part?? this function doesn't error. not me being obsessed with a function that just… works 🫶 no error paths, no drama, we love a low-stakes king.

ngl bestie, "doesn't error" is the whole personality here — no return-code checking needed, just vibe and go 💀

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_preempt_fence.c — go read the source, iykyk 📖
• xe_preempt_fence_alloc(9)
• xe_preempt_fence_free(9)
• xe_preempt_fence_create(9)

---

and that's the page, bestie 🎀 this one shipped out of ./drivers/gpu/drm/xe back in October 2026, filed under xe_preempt_fence_arm(9) in the Kernel API Manual — slay, go arm some fences 💜🦋