dpll_device_get(9)

💖 dpll_device_get(9) 💖

okay so this is a page from the Kernel API Manual (yes, the kernel kernel, we're being serious and adorable at the same time) and today's main character is dpll_device_get — the function that finds you an existing dpll device or, if there isn't one yet, just goes ahead and makes you a fresh one. icon behavior, honestly.

---

✨ NAME ✨

dpll_device_get — find an existing dpll device, or create a new one, bestie 💅

---

🌸 SYNOPSIS 🌸

struct dpll_device * dpll_device_get (u64 clock_id , u32 device_idx ,
       struct module *module , dpll_tracker *tracker );

like… look at that signature. so structured. so valid. 🎀

---

🦋 ARGUMENTS 🦋

• clock_id — the clock_id of whoever created this thing (the creator's clock id, no cap)
• device_idx — the index handed to you by the device driver, it's literally the driver's own little label
• module — a reference to the module that's registering
• tracker — the tracking object for the reference you just acquired, so nobody loses track of it 🫶

---

💜 DESCRIPTION 💜

okay so the whole vibe: you call this and it gets you the existing object of a dpll device — and that object is unique for the arguments you passed in. and if that object doesn't exist yet? it creates a new one. yes ma'am, find-or-create, we love a function that does both 😭

---

🔥 CONTEXT 🔥

it acquires a lock — specifically dpll_lock. so like, be aware, there's locking going on. don't be weird about it. ⭐

---

👑 RETURN 👑

• a valid dpll_device struct pointer if it succeeded 🎉
• ERR_PTR(X) — that's the error case, and it's an error 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/dpll/dpll_core.c
• 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)
• dpll_pin_own_dpll_ref_first(9)

like, that's the whole friend group right there. go read them too, iykyk 💖

---

alright bestie, that's the page! 🧚 it lives over in ./drivers/dpll, and it's dated October 2026 — so mark your calendars, this one's from the future (or at least from the version string's dreams). slay, bye! 💅✨🍓