ahci_platform_find_clk(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ahci_platform_find_clk(9) — like, the Kernel API Manual one, bestie 🎀

okay so real talk, we're in the Kernel API Manual today, section 9, and the star of the show is ahci_platform_find_clk. it's giving "small function, big responsibilities" and honestly? we're obsessed. ✨

🌸 NAME 🌸

ahci_platform_find_clk — Find platform clock 🕰️✨ (yes that's literally it, she's a finder, that's her whole job, and she ate)

🦋 SYNOPSIS 🦋

struct clk * ahci_platform_find_clk (struct ahci_host_priv *hpriv ,
const char *con_id );

like, she takes two things and gives you back a struct clk *. no cap. 💅

💖 ARGUMENTS 💖

  • hpriv — the host private area where config values get stored 🫶 (it's the lil' stash spot, iykyk)
  • con_id — the clock connection ID 🎀 (your ticket to the right clock, fr fr)

⭐ DESCRIPTION ⭐

okay so here's the tea: this function returns a pointer to the clock descriptor of the clock with the passed ID. that's it. that's the vibe check. 🔥

you hand her a con_id, she hands you back the clock descriptor — match made in heaven, lowkey iconic. 👑

🧚 RETURN 🧚

Pointer to the clock descriptor on success 💖 — otherwise NULL 😭 (and yes, NULL is the sad little "nope, didn't find her" ending, we've all been there)

🌈 SEE ALSO 🌈

first up, the actual source file (go read it, it's a whole mood):

  • Kernel file ./drivers/ata/libahci_platform.c

and then the whole friend group 🫶 — the entire ahci_platform squad, all here, all linked, no one left behind:

💀 quick reminder bestie: enable/disable, assert/deassert, suspend/resume — they come in pairs, do not mix them up, that's how you get main character energy of the wrong kind 🙈

🍓 SIGN-OFF 🍓

that's the whole page, bestie! 🦋 this lil' gem lives over in ./drivers/ata and it was dated October 2026 — so go forth, find your clocks, and remember: if it returns NULL, it's not you, it's the connection ID. 💜

ahci_platform_find_clk(9) — periodt. 👑💅✨

📦 where this page comes from