STRUCT XE_GUC_CT_SNAPSHOT(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… NAME

struct xe_guc_ct_snapshot β€” the GuC command transport (CT) snapshot, bestie. It's literally a lil frozen moment in time of the CT, no cap ✨


🌸 SYNOPSIS 🌸

struct xe_guc_ct_snapshot {
    bool ct_enabled;
    u32 g2h_outstanding;
    struct guc_ctb_snapshot g2h;
    struct guc_ctb_snapshot h2g;
    size_t ctb_size;
    void *ctb;
 };

Okay so quick vibe check: this is a struct, it's defined in the Kernel API Manual, and yeah the closing brace has that one extra space before the semicolon. That's canon. We don't touch it. πŸŽ€


🫢 Members

  • ct_enabled β€” whether the CT was enabled or not, captured right at the moment the snapshot got taken. It's giving "receipts at capture time" πŸ’…
  • g2h_outstanding β€” the G2H outstanding info, also as it was at capture time. Same timestamp energy, different fact. πŸ¦‹
  • g2h β€” the G2H CTB snapshot. Yep, the whole snapshot-of-a-CTB situation for the G2H direction. πŸ‘‘
  • h2g β€” the H2G CTB snapshot. Same deal, other direction. Symmetry ate. 🌈
  • ctb_size β€” the size of the snapshot of the CTB. Numbers girlies rise πŸ™ˆ
  • ctb β€” the snapshot of the entire CTB. The whole thing. Not a piece, not a sample β€” the entire CTB, frozen. πŸ”₯
Ngl there's no extra behaviour spelled out here beyond "this is the info at capture time" β€” so don't go reading secret lore into it. It's a snapshot struct. It snapshots. Periodt. πŸ’€

⭐ SEE ALSO ⭐

If you wanna go deeper (and honestly, obsessed that you do 🫢), go read these:

  • ./drivers/gpu/drm/xe/xe_guc_ct_types.h
  • struct guc_ctb_info(9)
  • struct guc_ctb(9)
  • struct guc_ctb_snapshot(9)
  • enum xe_guc_ct_state(9)
  • struct xe_guc_ct(9)

And that's the whole page, bestie β€” mwah πŸ’– This lil drop came from ./drivers/gpu/drm/xe, dated October 2026, from the Kernel API Manual (that's the manual name, folded in near the top like we promised πŸŽ€). Go read some kernel source, ily, bye ✨🧚

πŸ“¦ where this page comes from