pm_clk_destroy(9)

🎀 pm_clk_destroy(9) — the Kernel API Manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual (that's the manual name, iykyk) and it's all about pm_clk_destroy — one little function with main character energy. Let's get into it 💅

---

✨ NAME ✨

pm_clk_destroy — literally destroys a device's list of power management clocks. no cap, that's the whole vibe check 🫶

---

🌸 SYNOPSIS 🌸

void pm_clk_destroy (struct device *dev );

that's it. that's the signature. it returns void, so it gives you nothing back emotionally except closure 💀

---

🦋 ARGUMENTS 🦋

• dev — the Device whose list of PM clocks you're about to destroy. it's dev. it's the main character here. you hand it over and the list gets cleared out 🌈

---

💖 DESCRIPTION 💖

so here's the tea, bestie 🍓 this function does three things and it does them in order:

1. it clears the dev's power.subsys_data field — like, that field? empty now.
2. it removes the list of clock entries from the struct pm_subsys_data object that field was pointing to. all the clock entries? gone. from that object? yes.
3. it frees that object — struct pm_subsys_data? bye bestie, free'd.

the way that it just clears, removes, and frees 🧚 iconic behaviour, honestly.

⚠️ heads up: the original phrasing is "before and free that object" — so the removing of clock entries happens before the freeing. order matters, don't come for me 🔥

---

👑 SEE ALSO 👑

all the sibling functions in the same little friend group — go say hi 💜

• Kernel file ./drivers/base/power/clock_ops.c 📁 (that's where all these live)
• pm_clk_list_lock(9)
• pm_clk_list_unlock(9)
• pm_clk_op_lock(9)
• pm_clk_op_unlock(9)
• __pm_clk_enable(9)
• pm_clk_acquire(9)
• pm_clk_add(9)
• pm_clk_add_clk(9)
• of_pm_clk_add_clks(9)
• __pm_clk_remove(9)
• pm_clk_remove_clk(9)
• pm_clk_init(9)
• pm_clk_create(9)
• pm_clk_suspend(9)
• pm_clk_resume(9)
• pm_clk_notify(9)
• enable_clock(9)
• disable_clock(9)
• pm_clk_notify(9) — yes it's listed again, and honestly? she said it twice because she meant it 💀✨
• pm_clk_add_notifier(9)

---

and that's the whole page, bestie!! 🥳 a cute lil sign-off for you: this one comes courtesy of ./drivers/base/power — the source/version corner of the page — and it's dated October 2026, so it's basically from the future 💫 periodt. 🎀