__label_find(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 __label_find — the NAME moment 💅

okay so first things first: we're in the Kernel API Manual, section 9, and this page is literally titled __label_find(9). it's giving "find a label in a label set" energy and honestly? iconic. let's get into it bestie 🦋

✨ SYNOPSIS ✨

struct aa_label * __label_find (struct aa_label *label );

that's the whole vibe. one function, one arg, returns a struct aa_label *. slay.

🌸 ARGUMENTS 🌸

  • label — the label you're tryna find. and bestie, listen: it's NOT NULL. like, don't even think about passing NULL, that's not the move 🙈

💖 DESCRIPTION 💖

okay so the requirements here are so important, don't skip them:

Requires: labels_set(label)->lock held — that's the lock from labels_set(label), and you gotta be holding it. also the caller has to hold a valid ref on l. no cap, that's the deal 💅

👑 RETURN 👑

so what do you actually get back? two slay outcomes and one sad one:

  • a ref counted label if label is in the tree 🎉
  • a ref counted label that is equivalent to label in the tree — so like, not the exact same one but it is giving the same thing ✨
  • NULL if neither label nor its equivalent is in the tree 😭 that's the flop case

🔥 SEE ALSO 🔥

the link-up list is long and every single one of these is a main character. no skips, no cuts 🫶

also, for the record, these all live in the kernel file ./security/apparmor/label.c — that's the source location, iykyk 📁

okay that's the whole page, bestie 💜 this one came out of ./security/apparmor, dated October 2026, and it's filed under __label_find(9). drink some water, hold your lock, and go find those labels ✨🧚‍♀️

📦 where this page comes from