STRUCT GUC_LFD_FILE_HEADER(9)

🎀 struct guc_lfd_file_header(9) 🎀

okay so bestie, welcome to the <purple>Kernel API Manual</purple> entry for struct guc_lfd_file_header — literally the header of the GuC Log Streaming-LFD-File Format ✨. What does it do? It encapsulates the layout of the guc-log-file format. that's it, that's the whole vibe. it's giving "the envelope that tells you what's inside the envelope." 💌

💅 SYNOPSIS

struct guc_lfd_file_header {
    u64 magic;
    u32 version;
  #define GUC_LFD_FILE_HEADER_VERSION_MASK_MAJOR  GENMASK(31, 16);
  #define GUC_LFD_FILE_HEADER_VERSION_MASK_MINOR  GENMASK(15, 0);
    u32 stream[];
 };

like, look at her. iconic. no notes. 👑

🌸 Members

• magic — a magic number, set by the producer of a GuC log file, whose whole job is to identify that the file is a valid guc-log-file containing a stream of LFDs. it's the secret handshake, the "iykyk" of file headers fr fr 🔥
• version — the version of this file format layout. tell me what era of the format we're living in bestie 🦋
• stream — a stream of one or more guc_lfd_data LFD blocks. one or more!! she's flexible!! 🌈

ngl, the stream[] is a flexible array member — but don't take that as tech advice from me, the manpage just says it's a stream of one or more blocks, and I'm just the messenger 🫶

👀 SEE ALSO

• Kernel file ./drivers/gpu/drm/xe/abi/guc_lfd_abi.h — go read the actual ABI, bestie, it's right there 📂
• struct guc_lfd_data_log_events_buf(9) — her sibling, also slaying in her own lane 💜

and that's the whole page, periodt. 💅 if you need to find her again she lives at ./drivers/gpu/drm/xe/abi in the kernel tree, and this cutie was dated October 2026 — no cap, bookmark it, screenshot it, put it on your fridge. 🎀✨💖