ENUM DPLL_LOCK_STATUS(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… enum dpll_lock_status(9) πŸ’…

okay bestie, welcome to the Kernel API Manual ✨ this one's all about enum dpll_lock_status β€” it's the little enum that spills the tea on your dpll device's lock status, and it holds the valid values for the DPLL_A_LOCK_STATUS attribute. no cap, that's literally its whole job 🫢


✨ NAME ✨

enum dpll_lock_status β€” provides information of dpll device lock status, valid values for DPLL_A_LOCK_STATUS attribute 🌸


πŸ¦‹ SYNOPSIS πŸ¦‹

enum dpll_lock_status {
    DPLL_LOCK_STATUS_UNLOCKED ,
    DPLL_LOCK_STATUS_LOCKED ,
    DPLL_LOCK_STATUS_LOCKED_HO_ACQ ,
    DPLL_LOCK_STATUS_HOLDOVER

};

like… look at her. four constants, zero drama (well, okay, a little drama β€” see below πŸ‘€).


πŸŽ€ Constants πŸŽ€

  • DPLL_LOCK_STATUS_UNLOCKED β€” the dpll was not yet locked to any valid input, or it got forced into this by setting DPLL_A_MODE to DPLL_MODE_DETACHED. it's giving "situationship with the signal" πŸ™ˆ
  • DPLL_LOCK_STATUS_LOCKED β€” slay, the dpll is locked to a valid signal, but ngl there's no holdover available. locked in but not locked in, ykwim? πŸ’…
  • DPLL_LOCK_STATUS_LOCKED_HO_ACQ β€” the dpll is locked and holdover acquired. main character energy, fully committed, holding it down πŸ‘‘
  • DPLL_LOCK_STATUS_HOLDOVER β€” the dpll is in holdover state, meaning it lost a valid lock, or it was forced into this by disconnecting all the pins. 🫠
okay so important caveat bestie, don't skip this: that "forced by disconnecting all the pins" option is only possible when the dpll lock-state was already DPLL_LOCK_STATUS_LOCKED_HO_ACQ. if the dpll lock-state was not DPLL_LOCK_STATUS_LOCKED_HO_ACQ, then the dpll's lock-state shall remain DPLL_LOCK_STATUS_UNLOCKED. literally the rules, fr fr πŸ’€

🌈 SEE ALSO 🌈

kernel file ./include/uapi/linux/dpll.h, plus the whole friend group:

  • enum dpll_mode(9)
  • enum dpll_lock_status_error(9)
  • enum dpll_type(9)
  • enum dpll_pin_type(9)
  • enum dpll_pin_direction(9)
  • enum dpll_pin_state(9)
  • enum dpll_pin_operstate(9)
  • enum dpll_pin_capabilities(9)
  • enum dpll_feature_state(9)

go read them, iykyk 🧚


and that's the whole page, bestie!! mwah πŸ’– this lil icon lives in ./include/uapi/linux and the version stamp says October 2026 β€” so like, future vibes only ⭐ stay locked (or at least DPLL_LOCK_STATUS_LOCKED_HO_ACQ) πŸŽ€πŸ¦‹πŸ’œ

πŸ“¦ where this page comes from