clk_bulk_get_all(9)

📦 version 7.3.1, in nixpkgs unstable

💅 clk_bulk_get_all(9) — the Kernel API Manual page, bestie edition ✨

okay so this is a page from the Kernel API Manual, and it's about clk_bulk_get_all — yes the whole gang of clocks at once, we love a bulk moment 🫶

🌸 NAME 🌸

clk_bulk_get_all — lookup and obtain all available references to clock producer. all of them. every single one. no cap 💅

✨ SYNOPSIS ✨

int clk_bulk_get_all (struct device *dev , struct clk_bulk_data **clks );

like literally that's the whole signature, she's compact and she knows it 🎀

🦋 ARGUMENTS 🦋

  • dev — the device for clock "consumer" 👑 (yep, "consumer" in quotes, that's how the page says it, we're not changing it)
  • clks — pointer to the clk_bulk_data table of consumer. this is where all the acquired clock references get parked 🚗✨

💖 DESCRIPTION 💖

so this helper function lets drivers get all clk consumers in one operation — one call, whole squad acquired, iconic behaviour honestly ⭐

but listen: if any of the clk cannot be acquired, then any clks that were obtained will be freed before returning to the caller. no half-finished vibes, she cleans up after herself 🧹💅

here's the return-value tea ☕:

  • Returns a positive value for the number of clocks obtained, while the clock references are stored in the clk_bulk_data table in clks field. 🎀
  • Returns 0 if there're none.
  • Returns a negative value if something failed. 😭
🚨 drivers must assume that the clock source is not enabled. do not assume it's on, bestie. it is not. periodt.
💀 and fr fr: clk_bulk_get should not be called from within interrupt context. just don't. not the vibe, not the move, not today 🙈

🌈 SEE ALSO 🌈

the whole extended family, gathered for the group chat 🫶:

and that's the page, bestie 💜 it's from ./include/linux, dated October 2026, and it goes by clk_bulk_get_all(9) — go get those clocks, but like, all of them 🕐✨🎀

📦 where this page comes from