clk_hw_forward_rate_request(9)

📦 version 7.3.1, in nixpkgs unstable

💅 clk_hw_forward_rate_request — the Kernel API Manual, bestie edition ✨

okay so real quick, before we get into it: this is a page from the Kernel API Manual about clk_hw_forward_rate_request(9). yes the name is a mouthful. no we're not renaming it. it's iconic, it stays. 🎀

✨ NAME ✨

clk_hw_forward_rate_request — literally just forwards a clk_rate_request to a clock's parent. that's the whole gig. it's giving "middle manager relaying a message upstairs" energy and honestly? slay. 💅

🦋 SYNOPSIS 🦋

void clk_hw_forward_rate_request (const struct clk_hw *hw , const struct
clk_rate_request *old_req , const struct clk_hw *parent , struct
clk_rate_request *req , unsigned long parent_rate );

no cap, that's five arguments and a void return. she doesn't return anything, she just does. main character energy fr fr. 👑

🌸 ARGUMENTS 🌸

  • hw — the original clock that got the rate request. like, the one who received the DM first. 📨
  • old_req — the original clk_rate_request structure we want to forward. this is the message being passed along, untouched, like a group chat screenshot.
  • parent — the clk we want to forward old_req to. the parent. the one who actually has to deal with it now. 😭
  • req — the clk_rate_request structure we want to initialise. yes, a different one. bestie, you're filling in a fresh one to hand over. 🫶
  • parent_rate — the rate which is to be requested to parent. it's a unsigned long, it's the actual number, it's the whole point. 🔥

💜 DESCRIPTION 💜

So what does it do? It initialises a clk_rate_request structure to submit to a clock parent inside __clk_determine_rate or similar functions.

that's it. that's the function. it takes the request that came in, and preps a shiny new request struct so the parent clock can get asked the same question. the way that a rate request just hops up the clock tree one level at a time… obsessed. 🌈

ngl, the wording here is "or similar functions" — so the manpage is being a little vague about exactly where you'd call it. don't come for me, I'm just relaying what it says. ⭐

🧚 SEE ALSO 🧚

Kernel file ./drivers/clk/clk.c — that's where she lives, that's her home. 🏡

and now, the extended fam (there's like… a lot of them, and they all have (9) after their name because that's just how kernel API manpages roll):

like I said. a LOT of cousins. drink some water before you go clicking through all of those. 🍓

💀 anyway, that's the whole page. short and sweet, just like a good git commit message.

🌸 mwah, bye bestie! this page came out of ./drivers/clk, dated October 2026, and it's filed under the name clk_hw_forward_rate_request(9) in the Kernel API Manual. don't forget where you found her. 🫶✨

📦 where this page comes from