efi_capsule_pending(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

✨ efi_capsule_pending πŸ’…

okay so bestie, welcome to the Kernel API Manual β€” yes we're reading kernel docs together, this is our bonding time 🫢


🌸 NAME 🌸

efi_capsule_pending β€” has a capsule been passed to the firmware? πŸ‘€ like, is it pending or not, that's the whole vibe check


πŸŽ€ SYNOPSIS πŸŽ€

bool efi_capsule_pending (int *reset_type );

πŸ’– ARGUMENTS πŸ’–

  • reset_type β€” this is where you stash the type of EFI reset if a capsule is pending. it's literally the output slot, bestie, that's its whole job 🫑

πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea β˜• β€” to make sure the registered capsule gets processed correctly by the firmware, we have to perform a specific type of reset. so: if a capsule is pending, this function returns the reset type in reset_type. that's it, that's the deal ✨

⚠️ race condition alert, no cap β€” this function will race with callers of efi_capsule_update. like, for example: you call this function while somebody else is in efi_capsule_update but hasn't reached efi_capsue_update_locked yet β€” you will miss the updates to capsule_pending and efi_reset_type after efi_capsule_update_locked completes. 😭 rip

a non-racy use is from platform reboot code, because we use system_state to make sure no capsules can be sent to the firmware once we're at SYSTEM_RESTART. iconic behavior honestly πŸ‘‘ see efi_capsule_update_locked.


πŸ”₯ SEE ALSO πŸ”₯

kernel file ./drivers/firmware/efi/capsule.c β€” and also go read:


okay that's the whole page, go forth and know thy capsules πŸ§šπŸ’œ

β€” source/version: ./drivers/firmware/efi β€” dated October 2026 ✨ slay, see you in the next manpage bestie πŸŽ€

πŸ“¦ where this page comes from