request_key_with_auxdata(9)

💅 request_key_with_auxdata — Kernel API Manual, bestie edition

okay so this is request_key_with_auxdata(9) from the Kernel API Manual — yes the whole manual, we're doing this 💖 — and it's literally the key-requesting function that also carries aux data for the upcaller. stay with me, it's actually not that deep 🫶

---

✨ NAME ✨

request_key_with_auxdata — request a key, but like, with auxiliary data for the upcaller 🎀

---

🌸 SYNOPSIS 🌸

struct key * request_key_with_auxdata (struct key_type *type , const
char *description , struct key_tag *domain_tag , const void
*callout_info , size_t callout_len , void *aux );

---

🦋 ARGUMENTS 🦋

• type — the type of key we want. the vibe of key, basically ✨
• description — the searchable description of the key. this is how you find it again later, no cap 🔍
• domain_tag — the domain in which the key operates. where it lives, its little neighborhood 🏡
• callout_info — the data to pass to the instantiation upcall (or NULL). yes, NULL is allowed, she's flexible 💅
• callout_len — the length of callout_info. gotta tell it how big the data is 📏
• aux — auxiliary data for the upcall. the extra lil garnish 🍓

---

💜 DESCRIPTION 💜

so it's exactly like request_key_and_link, except — and this is the main character detail — it does not add the returned key to a keyring if found, and new keys are always allocated in the user's quota. periodt ✨

on top of that, it then works as wait_for_key_construction to wait for the completion of keys undergoing construction, with a non-interruptible wait. like, it's committed. it's not taking interruptions, bestie 😭

ngl, that non-interruptible wait is the part you should actually remember — it means you're waiting and you can't just politely bail out 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./security/keys/request_key.c
• complete_request_key(9)
• request_key_and_link(9)
• wait_for_key_construction(9)
• request_key_tag(9)
• request_key_rcu(9)

go read those, iykyk 📚

---

and that's the whole page, bestie 🫶 this icon was brought to you by the kernel file ./security/keys, dated October 2026, and yes the page is literally called request_key_with_auxdata(9) — iconic name, no notes 👑💖