zynqmp_pm_cl...get_topology(9)

📦 version 7.3.1, in nixpkgs unstable

✨ zynqmp_pm_cl...get_topology(9) ✨

okay bestie, so this is a page from the Kernel API Manual (section 9, the kernel-space girlies 😌) and it's literally all about zynqmp_pm_clock_get_topology. let's get into it 💅

🎀 NAME 🎀

zynqmp_pm_clock_get_topology — get the topology of clock for given id. that's it, that's the whole vibe 🦋

🌸 SYNOPSIS 🌸

int zynqmp_pm_clock_get_topology (u32 clock_id , u32 index , struct
       topology_resp *response );

she takes three args and returns an int, no cap ✨

💖 ARGUMENTS 💖

  • clock_id — ID of the clock to be queried. like, which clock are we snooping on 👀
  • index — Node index of clock topology. this is your pagination cursor basically, iykyk
  • response — Buffer used for the topology response. she's gotta put the answer somewhere 🫶

🦋 DESCRIPTION 🦋

This function is used to get topology information for the clock specified by given clock ID. literally its whole job 💅

so here's the tea: this API will return 3 node of topology with a single response. THREE. at a time. that's the batch size, periodt.

To get other nodes, master should call same API in loop with new index till error is returned. so you're gonna be looping, bestie 🔁

E.g First call should have index 0 which will return nodes 0,1 and 2. Next call, index should be 3 which will return nodes 3,4 and 5 and so on. see the pattern? 0 → 3 → 6 → and so on until it yells at you 😭

⚠️ don't forget the "till error is returned" part — that error is your signal that you've hit the end of the topology. it's giving "the loop terminator is the error" and honestly? iconic but also mind the vibes 💀

🔥 RETURN 🔥

0 on success else error+reason 🌈

(yes, "error+reason" — that's the literal wording, I'm not gonna lie to you 🍓)

👑 SEE ALSO 👑

Kernel file ./drivers/clk/zynqmp/clkc.c plus this whole friend group:

like, the whole zynqmp clock crew showed up to the group chat 🧚✨

and that's the page!! mwah 💋

this lil masterpiece lives in ./drivers/clk/zynqmp, stamped October 2026, and goes by zynqmp_pm_cl...get_topology(9) — yes the name is abbreviated in the corner and yes we're keeping it exactly like that, fr fr 💜

📦 where this page comes from