intel_engine_cmd_parser(9)

💅 intel_engine_cmd_parser(9)

okay so bestie, welcome to the Kernel API Manual ✨ this one lives in the intel_engine_cmd_parser(9) section and it's literally the bouncer at the club door for batch buffers 🫶

---

🌸 NAME 🌸

intel_engine_cmd_parser — parse a batch buffer for privilege violations

like, it reads the batch and goes "ma'am, you cannot sit here" if anything's being shady 👑

---

🎀 SYNOPSIS 🎀

int intel_engine_cmd_parser (struct intel_engine_cs *engine , struct
i915_vma *batch , unsigned long batch_offset , unsigned long
batch_length , struct i915_vma *shadow , bool trampoline );

that's the whole vibe, no cap 💫

---

🦋 ARGUMENTS 🦋

• engine — the engine on which the batch is to execute ✨ like, which little GPU engine is gonna run this thing
• batch — the batch buffer in question 🙈 the main character of this whole story
• batch_offset — byte offset in the batch at which execution starts, lowkey where the party begins
• batch_length — length of the commands in batch_obj 📏 (yes, it says batch_obj, keep it, that's canon)
• shadow — validated copy of the batch buffer in question 🪞 the good twin, already checked
• trampoline — true if we need to trampoline into privileged execution 🎪 bounce bounce, but make it kernel

---

💖 DESCRIPTION 💖

Parses the specified batch buffer looking for privilege violations as described in the overview. fr fr, that's the whole job — it reads through the batch and sniffs out anyone trying to do something they're absolutely not allowed to do 💀

---

⭐ RETURN ⭐

• non-zero if the parser finds violations or otherwise fails — so any non-zero is a red flag bestie, run 🚩
• -EACCES if the batch appears legal but should use hardware parsing 👀 like it's technically fine but it needs to go through the hardware route, so it's still not a plain zero

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/i915/i915_cmd_parser.c batch buffer command parser(9)
• intel_engine_init_cmd_parser(9)
• intel_engine_cleanup_cmd_parser(9)
• i915_cmd_parser_get_version(9)

iykyk, go read the source file, it's giving essential lore 📚

---

and that's a wrap, bestie 💜 this iconic little page comes from ./drivers/gpu/drm/i915, dated October 2026, filed under the Kernel API Manual — slay, periodt 🎀✨