intel_guc_fw_upload(9)

💅 intel_guc_fw_upload(9) — a Kernel API Manual moment 🎀

okay so bestie, welcome to the Kernel API Manual, and today's main character is intel_guc_fw_upload 💖 she's the one who actually gets the GuC uCode onto the device, and honestly? iconic.

---

✨ NAME ✨

intel_guc_fw_upload — load GuC uCode to device. that's it, that's the vibe 🫶

---

🌸 SYNOPSIS 🌸

int intel_guc_fw_upload (struct intel_guc *guc );

literally her whole signature, no cap. keep it exactly like that, bestie 💅

---

🦋 ARGUMENTS 🦋

• guc — the intel_guc structure. that's the whole argument. she takes one (1) thing and she takes it seriously ✨

---

💜 DESCRIPTION 💜

so here's the tea ☕ — this is called from intel_uc_init_hw, and she shows up for three (3) big moments:

• during driver load 🔥
• resume from sleep 😴
• after a GPU reset 💀

the firmware image should already have been fetched into memory by the time she gets there — like, that part's done, thanks. so all she does is check that the fetch succeeded ✅, and then transfer the image to the h/w 🎀

that's the whole job. check the vibe, ship the image. periodt.

---

⭐ RETURN ⭐

non-zero code on error 😭 — so like, if you get back a zero you're slaying, if you don't… you're not 🙈

---

🌈 SEE ALSO 🌈

kernel file ./drivers/gpu/drm/i915/gt/uc/intel_guc_fw.c — go read her source, iykyk 👑

---

ngl bestie, remember: the image is already fetched before this runs. don't be out here assuming she fetches it. she does not. she checks and she transfers. that's the whole arc 🧚

---

okay that's the page!! 🍓 brought to you by the fine folks over at ./drivers/gpu/drm/i915/gt/uc, dated October 2026 — mwah, love u, go ship some firmware 💖💅✨