xe_pxp_exec_queue_add(9)

💅 xe_pxp_exec_queue_add(9) — the kernel API manual, but make it make sense

okay bestie, welcome to the <pink>xe_pxp_exec_queue_add</pink> page of the Kernel API Manual ✨ this one lives in the <purple>9</purple> section (that's the kernel API section, iykyk) and honestly? it's a short one. we love a concise icon.

---

🌸 NAME 🌸

xe_pxp_exec_queue_add — bestie's job is literally just "add a queue to the PXP list" 🎀 that's it, that's the whole vibe.

---

✨ SYNOPSIS ✨

int xe_pxp_exec_queue_add (struct xe_pxp *pxp , struct xe_exec_queue *q
);

like, yes, the formatting is a little chaotic in the original too, don't come for her 💀

---

🫶 ARGUMENTS 🫶

• pxp — the xe->pxp pointer. heads up: it's gonna be NULL if PXP is disabled, so check your vibe before you dereference anything 🙈
• q — the queue you're adding to the list. the main character of this whole operation tbh 👑

---

💖 DESCRIPTION 💖

okay so here's the tea ☕ if PXP is enabled and the prerequisites are already done, this function starts up the PXP default session (only if it's not already running, she's not doing that twice) and then adds the queue to the PXP list. easy.

and then the return values, which are the whole plot:

• returns <green>0</green> if the PXP session is running and the queue is in the list — slay, everything worked ✨
• returns <red>-ENODEV</red> if PXP is disabled — no device, no entry, no PXP for you 😭
• returns <red>-EBUSY</red> if the PXP prerequisites are not done yet — she's busy, try again later 💅
• returns, like, some other errno value if something goes wrong during the session start — other errno value, no specifics given, you'll know it when you see it 🦋

no cap, the error paths matter here: -ENODEV and -EBUSY mean very different things, so don't just lump them together, bestie 🫶

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/xe/xe_pxp.c PXP(9)
• xe_pxp_get_readiness_status(9)
• xe_pxp_irq_handler(9)
• xe_pxp_init(9)
• xe_pxp_exec_queue_set_type(9)
• xe_pxp_exec_queue_remove(9)
• xe_pxp_key_assign(9)
• xe_pxp_bo_key_check(9)
• xe_pxp_obj_key_check(9)
• xe_pxp_pm_suspend(9)
• xe_pxp_pm_resume(9)

---

and that's the whole page, bestie 🌈 this one came out of ./drivers/gpu/drm/xe and the manual is dated October 2026 — so, like, mark your calendars or whatever 🎀 go read the other xe_pxp_* pages, they're all linked above, and remember: <hotpink>xe_pxp_exec_queue_add(9)</hotpink> is the name, periodt 💅✨