xe_guard_arm(9)

💅 xe_guard_arm(9) — the guard-arming era

okay so bestie, welcome to xe_guard_arm(9), a page from the Kernel API Manual. no cap, this is the little function that decides who gets to hold the ✨guard✨ — keep reading, it's giving short-but-iconic.

---

🌸 NAME 🌸

xe_guard_arm — arm the guard for the exclusive/lockdown mode. literally that's the whole job. arm it. 💪

✨ SYNOPSIS ✨

int xe_guard_arm (struct xe_guard *guard , bool lockdown , void *who );

🎀 ARGUMENTS 🎀

• guard — the xe_guard to arm, bestie. this is the main character, the thing you're arming.
• lockdown — arm for lockdown (true) or exclusive (false) mode. two moods, one bool. 🦋
• who — optional owner info, and it's for debug only, so like… it's just there for the vibes and the forensics. 🙈

💅 DESCRIPTION 💅

okay so here's the tea 👑:

• Multiple lockdown requests are allowed. like, the more the merrier, no gatekeeping.
• Only a single exclusive access can be granted. one spot, one holder, periodt.
• It will fail if the guard is already in exclusive mode. already taken? not your turn. 💀
• On success, you must call xe_guard_disarm to release. yes, MUST. don't just walk away holding it, that's not the vibe. 😭

no cap on this one: if xe_guard_arm succeeds, xe_guard_disarm is not optional — it's how you give the guard back. 🫶

🔥 RETURN 🔥

0 on success or a negative error code on failure. slay when it's 0, check the negative when it's not. ⭐

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guard.h — struct xe_guard(9)
• xe_guard_init(9)
• xe_guard_disarm(9)
• xe_guard_mode_str(9)

go read those next, iykyk 🧚

---

💖 that's the whole page, bestie — from ./drivers/gpu/drm/xe, dated October 2026, and yes the footer says xe_guard_arm(9) too, we love a consistent queen. mwah, drink water, and remember to disarm 💜