STRUCT XE_GUC_SUBMIT_EXEC_QUEUE_SNAPSHOT(9)

💅 NAME 💅

struct xe_guc_submit_exec_queue_snapshot — bestie, it's literally a Snapshot for devcoredump ✨

So like, this is the Kernel API Manual page for it (you're reading the struct xe_gu...eue_snapshot(9) one, mwah) and we're gonna go through every single member, no skipping, no cap 🫶

🌸 SYNOPSIS 🌸

struct xe_guc_submit_exec_queue_snapshot {
    char name[MAX_FENCE_NAME_LEN];
    enum xe_engine_class class;
    u32 logical_mask;
    u16 width;
    u32 refcount;
    long sched_timeout;
    struct {
      u32 timeslice_us;
      u32 preempt_timeout_us;
    } sched_props;
    struct xe_lrc_snapshot **lrc;
    u32 schedule_state;
    unsigned long exec_queue_flags;
    struct {
      u32 wqi_head;
      u32 wqi_tail;
      u16 id;
    } guc;
    bool parallel_execution;
    struct {
      struct {
        u32 head;
        u32 tail;
        u32 status;
      } wq_desc;
      u32 wq[WQ_SIZE / sizeof(u32)];
    } parallel;
    struct {
      u32 primary;
      u8 pos;
      bool valid;
    } multi_queue;
 };

Obsessed with her honestly 🎀

🦋 MEMBERS 🦋

Okay so here's the whole cast, character by character, main character energy only 💖

• name — the name of this exec queue 🌸
• class — the class of this exec queue, iykyk
• logical_mask — logical mask of where a job submitted to the exec queue can actually run
• width — width of this exec queue, aka how many BB submitted per exec 👑
• refcount — ref count of this exec queue, keeping track of who's holding on
• sched_timeout — the time after which a job is removed from the scheduler. yes, removed, that's the whole point 😭
• sched_props — scheduling properties 💫
• sched_props.timeslice_us — timeslice period in micro-seconds ⏱️
• sched_props.preempt_timeout_us — preemption timeout in micro-seconds ⏱️
• lrc — LRC Snapshot, periodt
• schedule_state — Schedule State at the moment of Crash 💀 like a little crime scene photo
• exec_queue_flags — flags of the faulty exec_queue 🚩
• guc — GuC Engine Snapshot ✨
• guc.wqi_head — work queue item head
• guc.wqi_tail — work queue item tail
• guc.id — GuC id for this exec_queue 🪪
• parallel_execution — indication if the failure was during parallel execution 👀
• parallel — snapshot of the useful parallel scratch 🧚
• parallel.wq_desc — Workqueue description 📝
• parallel.wq_desc.head — Workqueue Head
• parallel.wq_desc.tail — Workqueue Tail
• parallel.wq_desc.status — Workqueue Status
• wq — Workqueue Items 🍓
• multi_queue — snapshot of the multi queue information 🌈
• multi_queue.primary — GuC id of the primary exec queue of the multi queue group 👑
• multi_queue.pos — position of the exec queue within the multi queue group 📍
• multi_queue.valid — the exec queue is part of a multi queue group ✅

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/xe/xe_guc_submit_types.h struct
• guc_submit_parallel_scratch(9)

Go read those too bestie, fr fr 💜

✨ Okay that's the whole page!! This iconic little manual lives at ./drivers/gpu/drm/xe, and it's dated October 2026 — so she's from the future, slay 🦋⏰ Thanks for reading, mwah, bye!! 💅🎀