efi_wait_for_key(9)

✨ efi_wait_for_key ✨

okay so bestie, welcome to efi_wait_for_key(9) from the Kernel API Manual 💖 this one's a little cutie from the EFI stub world and honestly it does exactly what it says on the tin: it waits for a key stroke. that's it. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

efi_status_t efi_wait_for_key (unsigned long usec , efi_input_key_t *key
);

literally just hand it a timeout and a place to stash the key, and it'll do the waiting for you 🫶

---

🦋 ARGUMENTS 🦋

• usec — the number of microseconds to wait for a key stroke ⏳ like, how long are we gonna sit here patiently before we give up, measured in millionths of a second, iykyk
• key — the key entered ⌨️ this is where the key stroke lands once somebody actually presses something

---

💅 DESCRIPTION 💅

Wait for up to usec microseconds for a key stroke. periodt. 💀

that's the entire plot, no cap — it's giving "patient bestie holding your spot in line" energy. it'll hang out for as long as usec says, hoping a key stroke shows up. 🌈

---

⭐ RETURN ⭐

Returns a status code, and it's EFI_SUCCESS if the key was received 👑 so like, if you get EFI_SUCCESS, congrats, somebody pressed a key and you caught it. slay. 🎉

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/firmware/efi/libstub/efi-stub-helper.c — go read the source, it's right there 📂
• efi_parse_options(9)
• efi_exit_boot_services(9)
• get_efi_config_table(9)
• efi_load_initrd_dev_path(9)
• efi_load_initrd(9)
• efi_remap_image(9)

all the EFI stub besties in one friend group, fr fr 🧚

---

and that's the page!! 🍓 this whole thing lives in ./drivers/firmware/efi/libstub, it's dated October 2026, and it's part of the Kernel API Manual 💜 go forth and wait for keys, icon. 💅✨