geni_se_clk_freq_match(9)

📦 version 7.3.1, in nixpkgs unstable

💅 geni_se_clk_freq_match(9) — or, how to find your clock's soulmate

okay so this is a page straight out of the Kernel API Manual, bestie. geni_se_clk_freq_match(9) — say it with me — is literally the function that goes "hmm, you want this frequency? let me find you the closest thing we actually have." matchmaker energy fr fr 💖

✨ NAME ✨

geni_se_clk_freq_match — Get the matching or closest SE clock frequency 🕐

🦋 SYNOPSIS 🦋

int geni_se_clk_freq_match (struct geni_se *se , unsigned long req_freq
, unsigned int *index , unsigned long *res_freq , bool exact );

🎀 ARGUMENTS 🎀

  • se — Pointer to the concerned serial engine. like, which SE are we talking about, bestie 🫶
  • req_freq — Requested clock frequency. the vibe you're asking for ✨
  • index — Index of the resultant frequency in the table. where it ended up living 👑
  • res_freq — Resultant frequency of the source clock. what you actually got 🌸
  • exact — Flag to indicate exact multiple requirement of the requested frequency. the "no compromises" switch 💅

🌈 DESCRIPTION 🌈

So here's the tea: this function gets called by the protocol drivers to determine the best match of the requested frequency, as provided by the serial engine clock, in order to meet the performance requirements. it's giving personal shopper for frequencies 🛍️

If we return success, then:

  • if exact is true, then res_freq / <an_integer> == req_freq ✅
  • if exact is false, then res_freq / <an_integer> <= req_freq ✅

💀 RETURN 💀

0 on success, standard Linux error codes on failure. slay when it works, standard-issue sadness when it doesn't 😭

🔥 SEE ALSO 🔥

(yes Overview(9) is in there twice, and no I'm not editing the source, that's just how it is bestie 🙈)

okay that's the whole page!! 🌟 this icon lives in ./drivers/soc/qcom, dated October 2026, and it answers to the name geni_se_clk_freq_match(9). mwah, go read your clock tables, ily 🫶💜

📦 where this page comes from