_init_main_clk(9)

💅 _init_main_clk — Kernel API Manual (yes bestie, the man page name is right there)

Okay so we're in _init_main_clk(9) territory, the Kernel API Manual, and honestly? It's a little guy with one job and it does it. Let's get into it 🎀

---

✨ NAME ✨

_init_main_clk — grab a struct clk * for the hwmod's main functional clock. That's it, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

int _init_main_clk (struct omap_hwmod *oh );

---

🦋 ARGUMENTS 🦋

• oh — a struct omap_hwmod *. Yeah, that's the whole description. The original said nothing more, so neither will I. Mysterious queen energy 👑

---

💖 DESCRIPTION 💖

So this function gets called from _init_clocks. Not by you, not by me — by _init_clocks. Respect the chain of command, bestie.

What it does: it populates the _clk on oh — that's the main functional clock pointer — and it does that if either a clock matching the hwmod name is found, or a main_clk is present. Either-or, both are valid paths, no cap.

Returns 0 on success or -EINVAL on error. So if you see -EINVAL? That's the "something's off" signal, literally. 😭

---

🔥 SEE ALSO 🔥

Kernel file ./arch/arm/mach-omap2/omap_hwmod.c, plus the whole extended friend group:

• struct clkctrl_provider(9)
• struct omap_hwmod_reset(9)
• struct omap_hwmod_soc_ops(9)
• _update_sysc_cache(9)
• _write_sysconfig(9)
• _set_master_standbymode(9)
• _set_slave_idlemode(9)
• _set_clockactivity(9)
• _set_softreset(9)
• _clear_softreset(9)
• _wait_softreset_complete(9)
• _set_dmadisable(9)
• _set_module_autoidle(9)
• _enable_wakeup(9)
• _add_initiator_dep(9)
• _del_initiator_dep(9)
• _init_interface_clks(9)
• _init_opt_clks(9)
• _enable_clocks(9)
• _omap4_clkctrl_managed_by_clkfwk(9)
• _omap4_has_clkctrl_clock(9)
• _disable_clocks(9)
• _omap4_enable_module(9)
• _omap4_wait_target_disable(9)
• _save_mpu_port_index(9)
• _find_mpu_rt_port(9)
• _enable_sysc(9)
• _idle_sysc(9)
• _shutdown_sysc(9)
• _lookup(9)
• _init_clkdm(9)
• _init_clocks(9)
• _lookup_hardreset(9)
• _assert_hardreset(9)
• _deassert_hardreset(9)
• _read_hardreset(9)
• _are_all_hardreset_lines_asserted(9)
• _are_any_hardreset_lines_asserted(9)
• _omap4_disable_module(9)
• _ocp_softreset(9)
• _reset(9)
• _omap4_update_context_lost(9)
• _omap4_get_context_lost(9)
• _enable(9)
• _idle(9)
• _shutdown(9)
• of_dev_hwmod_lookup(9)
• omap_hwmod_fix_mpu_rt_idx(9)
• omap_hwmod_parse_module_range(9)
• _init_mpu_rt_base(9)
• _init(9)
• _setup_iclk_autoidle(9)
• _setup_reset(9)
• _setup_postsetup(9)
• _setup(9)
• _register(9)
• _add_link(9)
• _register_link(9)
• _omap2xxx_3xxx_wait_target_ready(9)
• _omap4_wait_target_ready(9)
• _omap2_assert_hardreset(9)
• _omap2_deassert_hardreset(9)
• _omap2_is_hardreset_asserted(9)
• _omap4_assert_hardreset(9)
• _omap4_deassert_hardreset(9)
• _omap4_is_hardreset_asserted(9)
• _omap4_disable_direct_prcm(9)
• _am33xx_deassert_hardreset(9)
• omap_hwmod_softreset(9)
• omap_hwmod_lookup(9)
• omap_hwmod_for_each(9)
• omap_hwmod_register_links(9)
• _ensure_mpu_hwmod_is_setup(9)
• omap_hwmod_setup_one(9)
• omap_hwmod_check_sysc(9)
• omap_hwmod_init_regbits(9)
• omap_hwmod_init_reg_offs(9)
• omap_hwmod_init_sysc_flags(9)
• omap_hwmod_init_idlemodes(9)
• omap_hwmod_check_module(9)
• omap_hwmod_allocate_module(9)
• omap_hwmod_init_module(9)
• omap_hwmod_setup_earlycon_flags(9)
• omap_hwmod_setup_all(9)
• omap_hwmod_enable(9)
• omap_hwmod_idle(9)
• omap_hwmod_shutdown(9)
• omap_hwmod_get_mpu_rt_va(9)
• omap_hwmod_assert_hardreset(9)
• omap_hwmod_deassert_hardreset(9)
• omap_hwmod_for_each_by_class(9)
• omap_hwmod_set_postsetup_state(9)
• omap_hwmod_init(9)

Like I said. Extended friend group. Every single one of them is invited to the group chat 💀🫶

---

tiny sign-off 🧚

This lil page lives in ./arch/arm/mach-omap2 and it's dated October 2026 — so bestie, mark your calendar, because _init_main_clk(9) said "see you then" ✨💖