STRUCT CLK_CORE(9)

💅 NAME

struct clk_core — okay so real talk, this is the internal state of a clk in the clk tree, and it is lowkey the main character of the whole clock framework 🕰️✨ (also hiii, you're reading the struct clk_core(9) page from the Kernel API Manual, welcome bestie 🫶)

🎀 SYNOPSIS

struct clk_core {
    const char              *name;
    const struct clk_ops    *ops;
    struct clk_hw           *hw;
    struct module           *owner;
    struct device           *dev;
    struct hlist_node       rpm_node;
    struct device_node      *of_node;
    struct clk_core         *parent;
    struct clk_parent_map   *parents;
    u8 num_parents;
    u8 new_parent_index;
    unsigned long           rate;
    unsigned long           req_rate;
    unsigned long           new_rate;
    struct clk_core         *new_parent;
    struct clk_core         *new_child;
    unsigned long           flags;
    bool orphan;
    bool rpm_enabled;
    unsigned int            enable_count;
    unsigned int            prepare_count;
    unsigned int            protect_count;
    unsigned long           min_rate;
    unsigned long           max_rate;
    unsigned long           accuracy;
    int phase;
    struct clk_duty         duty;
    struct hlist_head       children;
    struct hlist_node       child_node;
    struct hlist_node       hashtable_node;
    struct hlist_head       clks;
    unsigned int            notifier_count;
  #ifdef CONFIG_DEBUG_FS;
    struct dentry           *dentry;
    struct hlist_node       debug_node;
  #endif;
    struct kref             ref;
 };

🦋 Members

name — the unique name of the clk, for identification. it's how the framework knows which clock you're talking about, no cap 💖
ops — pointer to the hardware-specific operations for this clk. the actual "how do I do the thing" instructions 🔧
hw — pointer used for traversing from a struct clk to its corresponding hardware-specific structure. your little bridge between worlds 🌉
owner — the kernel module that owns this clk (for reference counting). keeping the module alive so it doesn't ghost you 💀
dev — the device associated with this clk (optional)
rpm_node — node for runtime power management list management ⚡
of_node — the device tree node associated with this clk (if applicable) 🌳
parent — pointer to the current parent in the clock tree. family tree moment 👑
parents — array of possible parents (for muxes/selectable parents). the whole roster, not just the current fave ✨
num_parents — number of possible parents.
new_parent_index — index of the new parent during parent change operations. mid-switch era 🔄
rate — current cached clock rate (Hz). the vibe, numerically 🎵
req_rate — the last rate requested by a call to clk_set_rate. It's initialized to clk_core->rate. It's also updated to clk_core->rate every time the clock is reparented, and when we're doing the orphan -> !orphan transition. so it's the receipts of what was asked for 📝
new_rate — new rate to be set during a rate change operation.
new_parent — pointer to new parent during parent change. This is also used when a clk's rate is changed.
new_child — pointer to new child during reparenting. This is also used when a clk's rate is changed.
flags — clock property and capability flags. See clk framework flags 🚩
orphan — true if this clk is currently orphaned. it has no parent and it's going through it 😭
rpm_enabled — true if runtime power management is enabled for this clk.
enable_count — reference count of enables.
prepare_count — reference count of prepares.
protect_count — protection reference count against disable. iykyk, this one keeps it from getting shut off against its will 🛡️
min_rate — minimum supported clock rate (Hz).
max_rate — maximum supported clock rate (Hz).
accuracy — accuracy of the clock rate (parts per billion). how precise bestie is 🎯
phase — current phase (degrees).
duty — current duty cycle configuration (as ratio: num/den). 🍓
children — all of the children of this clk. the whole squad 👯
child_node — node for linking as a child in the parent's list.
hashtable_node — node for hash table that allows fast clk lookup by name. speed ✨💨
clks — all of the clk consumers registered.
notifier_count — number of notifiers registered for this clk. 🔔
dentry — DebugFS entry for this clk. (this one lives behind CONFIG_DEBUG_FS 💅)
debug_node — DebugFS node for this clk. (also a CONFIG_DEBUG_FS girlie 💅)
ref — reference count for structure lifetime management. keeps the whole thing from evaporating 🫶

🌈 Description

Managed by the clk framework. Clk providers and consumers do not interact with this structure directly — like, do not touch, it's not for you bestie 🙈. Instead, clk operations flow through the framework, and the framework manipulates this structure to keep track of parent/child relationships, rate, enable state, etc. it's the framework's private lil notebook, periodt 📓✨

and that's the page bestie!! 🫶 it ships from ./drivers/clk, dated October 2026, and it goes out under the name struct clk_core(9) — slay, go read clk.c 💖✨

📦 where this page comes from

nixpkgs unstable: linux-manual 7.3.1
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

STRUCT CLK_CORE(9)

💅 NAME

🎀 SYNOPSIS

🦋 Members

🌈 Description

👑 SEE ALSO