__dpll_device_change_ntf(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… __dpll_device_change_ntf(9) β€” like, the Kernel API Manual page, bestie πŸŽ€

okay so picture this: you're deep in the kernel, specifically in ./drivers/dpll, and something about your dpll device just changed and the whole world needs to know. that's literally this function. it's the little notification goblin 🧚 that tells everyone "hey!! the dpll device changed!!" and honestly? iconic.


✨ NAME ✨

__dpll_device_change_ntf β€” notify that the dpll device has been changed 🌸

like, that's the whole vibe. the device changed. we're telling people. periodt.


πŸ¦‹ SYNOPSIS πŸ¦‹

int __dpll_device_change_ntf (struct dpll_device *dpll );

yes that's the whole signature, and yes you're reading it right β€” one argument, returns an int, no cap πŸ’œ


🌈 ARGUMENTS 🌈

  • dpll β€” a registered dpll pointer. that's it. that's the whole argument. it's the device you're announcing to the world, so pls make sure it's actually registered before you come at it with this 🫢

πŸ”₯ CONTEXT πŸ”₯

okay this part is important so listen up πŸ™ˆ

the caller must hold dpll_lock. like, not optional, not "eh it'll probably be fine." must. hold. it. πŸ”’

and the cute part: this is suitable for use inside device callbacks which are already invoked under dpll_lock β€” so if you're already in there holding the lock (iykyk), you're chilling, you can just call it. no double-locking shenanigans, no deadlock drama πŸ’€


⭐ RETURN ⭐

  • 0 if it succeeds β€” slay, everything's fine ✨
  • an error code otherwise β€” not slay, but at least it tells you 😭

πŸ‘‘ SEE ALSO πŸ‘‘

go look at the kernel file ./drivers/dpll/dpll_netlink.c β€” that's where the magic lives, fr fr. and then these besties right here:

like, the whole friend group πŸ’– the device notifier, the pin notifiers, all of them. go say hi.


and that's the page!! πŸŽ€ brought to you by the fine people over in ./drivers/dpll, stamped October 2026 β€” mwah, love u, go hold that lock πŸ’‹πŸ’…

πŸ“¦ where this page comes from