_pwrdm_save_...and_activate(9)

📦 version 7.3.1, in nixpkgs unstable

🦋 _pwrdm_save_...and_activate(9) — like, the Kernel API Manual bestie edition 💅

okay so quick intro before we get into it: this is a page from the Kernel API Manual, and the star of the show is _pwrdm_save_clkdm_state_and_activate. yes the header lowkey truncates it to _pwrdm_save_...and_activate(9) and honestly? everyone just calls it by the nickname, it's fine 🫶

✨ NAME ✨

_pwrdm_save_clkdm_state_and_activate — prepare for power state change 🌸

🎀 SYNOPSIS 🎀

u8 _pwrdm_save_clkdm_state_and_activate (struct powerdomain *pwrdm , u8
curr_pwrst , u8 pwrst );

like yes she returns a u8, no cap 💖

⭐ ARGUMENTS ⭐

  • pwrdm — the struct powerdomain * you're operating on. that's the main character here 👑
  • curr_pwrst — the current power state of pwrdm (where it's at right now, not where it's going)
  • pwrst — the power state you wanna switch to. the destination. the vibe. ✨

💜 DESCRIPTION 💜

so basically this function's whole job is to figure out whether the powerdomain needs to be turned on before anything even attempts to switch power states. like, vibe check first, state change second, iykyk. 🔥

it's called by omap_set_pwrdm_state, so if you're tracing the call chain, that's your upstream bestie.

⚠️ okay important note, bestie, do NOT skip this one: NOTE that if the powerdomain contains multiple clockdomains, this code assumes that the first clockdomain supports software-supervised wakeup mode — which is potentially a problem. like, it's a real caveat, not me being dramatic. 🙈

and it returns the power state switch mode currently in use — for the deets on that, see the "Types of sleep_switch" comment above. it's up there, go look, it's iconic. 💀

🧚 SEE ALSO 🧚

the kernel file is ./arch/arm/mach-omap2/powerdomain.c, and literally all of these are family:

and that's the whole page, bestie, you ate it up 💅✨

cute little sign-off before you close the tab: this one lives under ./arch/arm/mach-omap2, dated October 2026, and it's the _pwrdm_save_...and_activate(9) page 🎀🦋 go forth and switch those power states responsibly 🌈

📦 where this page comes from