'\" t
.\"     Title: update_cfs_rq_load_avg
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: January 2017
.\"    Manual: Driver Basics
.\"    Source: Kernel Hackers Manual 4.8.15
.\"  Language: English
.\"
.TH "UPDATE_CFS_RQ_LOAD_A" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Driver Basics"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
update_cfs_rq_load_avg \- update the cfs_rq\*(Aqs load/util averages
.SH "SYNOPSIS"
.HP \w'int\ update_cfs_rq_load_avg('u
.BI "int update_cfs_rq_load_avg(u64\ " "now" ", struct\ cfs_rq\ *\ " "cfs_rq" ", bool\ " "update_freq" ");"
.SH "ARGUMENTS"
.PP
\fInow\fR
.RS 4
current time, as per
\fBcfs_rq_clock_task\fR
.RE
.PP
\fIcfs_rq\fR
.RS 4
cfs_rq to update
.RE
.PP
\fIupdate_freq\fR
.RS 4
should we call
\fBcfs_rq_util_change\fR
or will the call do so
.RE
.SH "DESCRIPTION"
.PP
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, see
\fBpost_init_entity_util_avg\fR\&.
.PP
cfs_rq\->avg is used for
\fBtask_h_load\fR
and
\fBupdate_cfs_share\fR
for example\&.
.PP
Returns true if the load decayed or we removed utilization\&. It is expected that one calls
\fBupdate_tg_load_avg\fR
on this condition, but after you\*(Aqve modified the cfs_rq avg (attach/detach), such that we propagate the new avg up\&.
.SH "COPYRIGHT"
.br