keyring_search(9)

🦋 keyring_search(9) — Kernel API Manual 🦋

okay so bestie, welcome to the Kernel API Manual — this page is literally about keyring_search(9), and it's here to search the supplied keyring tree for a matching key. 💅 no cap.

---

✨ NAME ✨

keyring_search — search the supplied keyring tree for a matching key. that's the whole assignment, bestie. 🎀

---

🌸 SYNOPSIS 🌸

key_ref_t keyring_search (key_ref_t keyring , struct key_type *type ,
const char *description , bool recurse );

---

💖 ARGUMENTS 💖

• keyring — the root of the keyring tree to be searched. it's giving main character of the search, periodt. 👑
• type — the type of keyring we want to find. gotta match the right vibe. 🦋
• description — the name of the keyring we want to find. yep, it's the name tag bestie. 🏷️
• recurse — True to search the children of keyring also. so if you want the whole fam involved, this is the one. 🌈

---

🔥 DESCRIPTION 🔥

It's exactly like keyring_search_rcu above, bestie — but this one is using the current task's credentials, plus type's default matching function and its preferred search method. slay, honestly. ✨

---

🌟 SEE ALSO 🌟

Kernel file ./security/keys/keyring.c — and the whole icon lineup: key_put_tag(9), key_remove_domain(9), restrict_link_reject(9), keyring_search_rcu(9), keyring_restrict(9), key_link(9), key_unlink(9), key_move(9), keyring_clear(9). iykyk 💜

---

mwah 💋 — this cutie came from ./security/keys, dated October 2026, and it's keyring_search(9) in the Kernel API Manual forever. bye bestie! 🫶