update_cfs_rq_load_avg(9)

okay so bestie, welcome to update_cfs_rq_load_avg(9) from the Kernel API Manual 🫶 this is the page for updating the cfs_rq’s load/util averages, and yes it’s giving scheduler-core main character energy 💅

🌸 NAME 🌸

update_cfs_rq_load_avg — update the cfs_rq’s load/util averages ✨

✨ SYNOPSIS ✨

int update_cfs_rq_load_avg (u64 now , struct cfs_rq *cfs_rq );

🎀 ARGUMENTS 🎀

• now — current time, as per cfs_rq_clock_pelt ⏰
• cfs_rq — cfs_rq to update 💖

💅 DESCRIPTION 💅

The cfs_rq avg is the direct sum of all its entities (blocked and runnable) avg. The immediate corollary is that all (fair) tasks must be attached. no cap, that’s the whole vibe 🧚

cfs_rq->avg is used for task_h_load and update_cfs_group, for example. iconic little fields, honestly 👑

Since both these conditions indicate a changed cfs_rq->avg.load, we should call update_tg_load_avg when this function returns true. periodt 💫

🔥 RETURN 🔥

true if the load decayed or we removed load. that’s the signal, bestie 😭

🦋 SEE ALSO 🦋

Kernel file ./kernel/sched/fair.c — also go peek at these:

• update_tg_load_avg(9)
• attach_entity_load_avg(9)
• detach_entity_load_avg(9)
• cpu_util(9)
• sched_use_asym_prio(9)
• sched_group_asym(9)
• update_sg_lb_stats(9)
• update_sd_pick_busiest(9)
• idle_cpu_without(9)
• update_sd_lb_stats(9)
• calculate_imbalance(9)
• sched_balance_find_src_group(9)

and that’s the page, bestie 🎀 source/version line says ./kernel/sched, date October 2026, footer title still update_cfs_rq_load_avg(9) — mwah 💋