xe_guc_min_l...for_hwconfig(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_guc_min_load_for_hwconfig 💅

okay bestie, welcome to the Kernel API Manual entry for xe_guc_min_l...for_hwconfig(9) — yes the title is literally abbreviated like that, no cap, that's just how the page rolls ✨

🌸 NAME 🌸

xe_guc_min_load_for_hwconfig — load a minimal GuC and read the hwconfig table 🎀

🦋 SYNOPSIS 🦋

int xe_guc_min_load_for_hwconfig (struct xe_guc *guc );

that's it, that's the whole vibe check — one function, one pointer, iconic 💅

✨ ARGUMENTS ✨

  • guc — the GuC object 🫶 literally the main character here, everything happens to it.

🔥 DESCRIPTION 🔥

okay so here's the whole plot, bestie:

First, this function uploads a minimal GuC — and ngl the key detail is that this minimal GuC does not support submissions, but it gets put in a state where the hwconfig table can be read. so it's like a lil baby GuC that can't do the fun stuff yet but can read the config 📖✨

Next, it reads and parses the hwconfig table so that table can be used for subsequent steps in the driver load. so yeah, this is setup-work, not the glamorous part, but the driver literally cannot proceed without it 🙈

Lastly, it enables CT communication — and the original is calling out an XXX note here: this is needed for PFs/VFs only 👑 (that's the manpage's own caveat, not me being dramatic, i'm just relaying it fr fr)

⭐ RETURN ⭐

  • 0 on success 🎉
  • negative error code on error 😭

like, that's the whole return contract, no surprises, we love a clean API 🌈

🧚 SEE ALSO 🧚

you already know we're linking the whole friend group 💖 kernel file ./drivers/gpu/drm/xe/xe_guc.c plus:

go read those too, iykyk 💜

ok real talk: any time this returns a negative error code, treat it as a genuine "something went wrong during load" signal — the manpage says negative error code on error and that's the whole truth, so don't go inventing meanings for specific values 🩷

and that's a wrap, bestie 🎀 this page lives in ./drivers/gpu/drm/xe, dated October 2026, and it's filed under xe_guc_min_l...for_hwconfig(9) — slay, go read the source 💅✨🦋

📦 where this page comes from