dpll_pin_own_dpll_ref_first(9)

💅 dpll_pin_own_dpll_ref_first(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes we're reading kernel docs together, that's just the kind of friendship we have 🫶

---

✨ NAME ✨

dpll_pin_own_dpll_ref_first — find the first owner dpll ref of a pin 🎀

---

✨ SYNOPSIS ✨

struct dpll_pin_ref * dpll_pin_own_dpll_ref_first (struct dpll_pin *pin
);

---

✨ ARGUMENTS ✨

• pin — pointer to a dpll pin 🌸 (that's the little guy we're investigating)

---

✨ DESCRIPTION ✨

okay so here's the vibe 💫 — this function goes digging through pin's dpll_refs, searching for a ref whose dpll matches the pin's (module, clock_id) tuple. iykyk, that means: the dpll that was registered by the driver that created the pin — its actual owner 👑.

why do we care bestie? because this makes sure pin-level attributes get reported and modified using the owner's ops 😤 even when that same pin is also registered with dplls from other drivers. like yes the pin is popular and hangs out with lots of dplls, but the owner still gets the final say. main character energy fr fr 💅

---

✨ RETURN ✨

pointer to the owner's dpll_pin_ref 🎯 — or NULL if no owner ref is found 😭 (no owner, no ref, sad times)

---

✨ SEE ALSO ✨

Kernel file ./drivers/dpll/dpll_core.c 🌈 plus all these iconic functions:

• dpll_device_get(9)
• dpll_device_put(9)
• dpll_device_register(9)
• dpll_device_unregister(9)
• dpll_pin_get(9)
• dpll_pin_put(9)
• dpll_pin_fwnode_set(9)
• fwnode_dpll_pin_find(9)
• dpll_pin_register(9)
• dpll_pin_unregister(9)
• dpll_pin_on_pin_register(9)
• dpll_pin_on_pin_unregister(9)
• dpll_pin_ref_sync_pair_add(9)

---

okay that's the whole page, you ate that 🍓 go forth and find those owner refs bestie!! 💖

anyway this lil masterpiece lives in ./drivers/dpll, dated October 2026, and it's filed under dpll_pin_own_dpll_ref_first(9) — periodt 💜✨