sugov_iowait_reset(9)

💅 sugov_iowait_reset(9) — the Kernel API Manual, bestie edition 🦋

okay so real talk, this is a page from the Kernel API Manual, and it's about sugov_iowait_reset — the little function that hits the reset button on a CPU's IO boost status. yes bestie, we're in scheduler-land today, hold my iced coffee 🧚

---

✨ NAME ✨

sugov_iowait_reset — resets the IO boost status of a CPU. that's it. that's the whole job. icon behavior honestly 👑

---

🌸 SYNOPSIS 🌸

bool sugov_iowait_reset (struct sugov_cpu *sg_cpu , u64 time , bool
set_iowait_boost );

it returns a bool, it takes three things, and it is not here to play games 💅

---

🎀 ARGUMENTS 🎀

• sg_cpu — the sugov data for the CPU that's getting boosted. like, the whole vibe dossier for that CPU 📁
• time — the update time, handed to us by whoever called us. thanks caller, very demure of you 🫶
• set_iowait_boost — true if an IO boost has actually been requested. false? then no boost was asked for, periodt ✋

---

🔥 DESCRIPTION 🔥

okay so here's the tea ☕ — the IO wait boost of a task gets disabled after a tick since the last update of a CPU. one tick, that's the window, that's the rule, no cap.

and if a new IO wait boost gets requested after more than a tick has passed? then we enable the boost starting from IOWAIT_BOOST_MIN 👑 and the reason is genuinely so slay: it improves energy efficiency by ignoring sporadic wakeups from IO. lowkey brilliant, highkey saving your battery 🌈

🫶 reminder bestie: that's more than a tick for the "start from IOWAIT_BOOST_MIN" path — the wording matters, don't let anyone gaslight you into thinking otherwise.

---

🦋 SEE ALSO 🦋

go read these next, i'm obsessed with them actually:

• Kernel file ./kernel/sched/cpufreq_schedutil.c 💖
• get_capacity_ref_freq(9)
• get_next_freq(9)
• sugov_iowait_boost(9)
• sugov_iowait_apply(9)

the whole friend group, all linked up, iykyk ⭐

---

and that's the page!! 💜 brought to you by ./kernel/sched — dated October 2026 — and yes, sugov_iowait_reset(9) is literally the main character of this manual page, no notes 🙈🎀