efi_capsule_setup_info(9)

💅 efi_capsule_setup_info(9) — like, the Kernel API Manual, but make it make sense

okay so bestie, welcome to the glow-up of efi_capsule_setup_info(9). this is a kernel API manual page, and no, it's not a skincare routine — it's about grabbing the EFI capsule header out of the binary and setting up the capsule_info structure. slay. let's get into it 💖

---

✨ NAME ✨

efi_capsule_setup_info — obtain the efi capsule header in the binary and setup capsule_info structure 🎀

like... it literally reaches into the binary, finds the efi capsule header, and then sets up the capsule_info structure. that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

int efi_capsule_setup_info (struct capsule_info *cap_info , void *kbuff
, size_t hdr_bytes );

(fr fr, copy it exactly like that — the spacing is part of the look, iykyk ✨)

---

🦋 ARGUMENTS 🦋

• cap_info — pointer to current instance of capsule_info structure. it's giving "the main character of this function call" energy 👑
• kbuff — a mapped first page buffer pointer. yes, first page. mapped. buffer. pointer. all three 💅
• hdr_bytes — the total received number of bytes for efi header. count 'em, bestie 🍓

---

🔥 DESCRIPTION 🔥

so here's the tea ☕ — platforms with non-standard capsule update mechanisms can override this __weak function so they can perform any required capsule image munging. that's the entire point: it's __weak, so you can absolutely step in and do your own thing if your platform is built different 💜

lowkey the whole thing is "default behavior is here, but you may override it" — and if you want to see what that looks like in practice, see quark_quirk_function for an example. iconic. it's right there, go look at it 🙈

ngl, this is the part where you either let the weak function do its thing or you make it your whole personality. both are valid, but the override is the moment ✨

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/firmware/efi/capsule-loader.c — literally where it lives, go read it 🧚
• efi_free_all_buff_pages(9)
• efi_capsule_submit_update(9)
• efi_capsule_write(9)
• efi_capsule_release(9)
• efi_capsule_open(9)

the whole capsule friend group, assembled 🫶

---

and that's the page, bestie!! 💖 this lil beauty comes to you straight from ./drivers/firmware/efi — the source/version, dated October 2026 — so yeah, mark your calendars, screenshot it, send it to the group chat. periodt. 💅🎀✨