dw_apb_clocksource_init(9)

💅 dw_apb_clocksource_init(9) — from the Kernel API Manual, bestie

okay so picture this: you've got an APB timer sitting there, all cute and ticking, and you want the kernel to actually use it as a clocksource. That's literally what this function is for. Let's get into it ✨

---

🌸 SYNOPSIS 🌸

struct dw_apb_clocksource * dw_apb_clocksource_init (unsigned rating ,
       const char *name , void __iomem *base , unsigned long freq );

She returns a struct dw_apb_clocksource *, no cap. Four arguments, all of them mandatory, so don't even think about skipping any 🫶

---

🎀 ARGUMENTS 🎀

• rating — the rating you're giving this clocksource. It's an unsigned. Yes, the kernel ranks its clocksources, and yes, this is how you tell it how much you believe in this timer.
• name — the name for the clocksource. const char *. Give her a name, she deserves one 💖
• base — the I/O base for the timer registers. Type is void __iomem *, i.e. one of those memory-mapped I/O pointers, don't just yeet a normal pointer in there.
• freq — the frequency that the timer counts at, as an unsigned long. Know your tick rate, bestie.

---

🦋 DESCRIPTION 🦋

So what this does: it creates a clocksource using an APB timer — but it does not yet register it with the clocksource system. That's the important bit, okay? She's built, she's not deployed.

Not me making a clocksource and then forgetting the second step 😭 The next step is dw_apb_clocksource_register. Do it. Don't leave her hanging.

So the whole flow is: dw_apb_clocksource_init first, then dw_apb_clocksource_register as the next step. Periodt 💅

---

👑 SEE ALSO 👑

• Kernel file ./drivers/clocksource/dw_apb_timer.c
• dw_apb_clockevent_init(9)
• dw_apb_clockevent_register(9)
• dw_apb_clocksource_start(9)
• dw_apb_clocksource_register(9)
• dw_apb_clocksource_read(9)

---

🌈 sign-off 🌈

This little gem lives in ./drivers/clocksource, dated October 2026, and the whole page is served up under the dw_apb_clocksource_init(9) header from the Kernel API Manual. Go forth and init your timers, bestie — and then register them 🧚💜