STRUCT GUC_CTB_INFO(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… struct guc_ctb_info(9) πŸ’…

okay so real talk, this is a page straight out of the Kernel API Manual and it's all about one lil struct, and honestly? she's iconic. no cap. let's get into it bestie 🫢


✨ NAME ✨

struct guc_ctb_info β€” the GuC command transport buffer (CTB) info πŸ’–

like, it's literally the info struct for the CTB. that's the whole vibe check.


🌸 SYNOPSIS 🌸

here's the whole struct, looking exactly like this, don't touch a single character:

struct guc_ctb_info {
    u32 size;
    u32 resv_space;
    u32 head;
    u32 tail;
    u32 space;
    bool broken;
 };

she's short, she's sweet, she's got six members and every single one of them matters. periodt.


πŸŽ€ Members πŸŽ€

okay bestie, let's go member by member because each one is doing her own lil job πŸ”₯

  • size β€” the size of the CTB commands, measured in DW. that's the whole capacity vibe.
  • resv_space β€” the reserved space of the CTB commands, also in DW. think of it as the part that's already spoken for πŸ’…
  • head β€” the head of the CTB commands, in DW. yes, she has a head, she's a whole creature.
  • tail β€” the tail of the CTB commands, in DW. head's bestie fr fr.
  • space β€” the space in the CTB commands, in DW. this is your actual room-to-breathe situation.
  • broken β€” a bool that says whether the channel is broken. and honestly? if this one's true, it's giving πŸ’€. dramatic but accurate.
πŸ¦‹ reminder: size, resv_space, head, tail and space are all measured in DW, and broken is the one and only bool in the group. don't mix them up, bestie.

πŸ‘‘ SEE ALSO πŸ‘‘

go read these next, they're literally the friend group 🌈

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

✨ and that's the whole page, bestie. she's filed under ./drivers/gpu/drm/xe, she's stamped October 2026, and she answers to the name struct guc_ctb_info(9). mwah πŸ’‹ go forth and read structs responsibly πŸ§šπŸ’œ

πŸ“¦ where this page comes from