am35xx_clk_find_companion(9)

💅 am35xx_clk_find_companion(9)

okay so bestie, buckle up — this is a page straight out of the Kernel API Manual, and the star of the show is am35xx_clk_find_companion. she's lowkey a matchmaker: her whole job is finding the companion clock to @clk. 🎀

---

✨ NAME ✨

am35xx_clk_find_companion — find companion clock to @clk 💞

---

🦋 SYNOPSIS 🦋

void am35xx_clk_find_companion (struct clk_hw_omap *clk , struct
       clk_omap_reg *other_reg , u8 *other_bit );

---

🌸 ARGUMENTS 🌸

• clk — the struct clk * you're trying to find the companion clock of. it's giving "who's your other half" energy 🫶
• other_reg — a void __iomem **, and it's where the companion clock's CM_*CLKEN virtual address gets returned. yes bestie, returned — through the pointer. classic. 🙈
• other_bit — a u8 **, and this one hands back the companion clock's bit shift. that's it, that's the whole vibe ⭐

---

💜 DESCRIPTION 💜

so here's the tea: some clocks literally don't have companion clocks. not every icon has a plus-one, yk? 😭 for example, modules that only have an interface clock (such as HECC) don't have a companion clock — no cap, that's just how she is.

right now, this code relies on the hardware exporting a bit in the correct companion register that indicates that the nonexistent "companion clock" is active. like... the hardware is out here pretending the bit means something and we're just going with it 💀

future patches will associate this type of code with per-module data structures to avoid this issue, and remove the casts. periodt, that's the roadmap 🔥

and the most important part: no return value. it's void, she returns nothing, she simply is. 👑

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/clk/ti/clk-3xxx.c
• omap3430es2_clk_ssi_find_idlest(9)
• omap3430es2_clk_dss_usbhost_find_idlest(9)
• omap3430es2_clk_hsotgusb_find_idlest(9)
• am35xx_clk_find_idlest(9)
• am35xx_clk_ipss_find_idlest(9)
• omap3_clk_lock_dpll5(9)

---

💡 friendly reminder: every one of those "find_idlest" friends is a separate manpage — go read them too, iykyk. 🧚

---

and that's the whole page, bestie! 🍓 this iconic little number lives in ./drivers/clk/ti, dated October 2026, and it's part of the Kernel API Manual — am35xx_clk_find_companion(9), forever and always. mwah 💋💖