Re: [RFC PATCH v2 3/3] sched/doc: Update the CPU capacity asymmetry bits

[Randy Dunlap]

On 4/28/21 2:32 AM, Beata Michalska wrote:
> Update the documentation bits referring to capacity aware scheduling
> with regards to newly introduced SD_ASYM_CPUCAPACITY_FULL shed_domain

                                                            sched_domain
I guess.

> flag.
> 
> Signed-off-by: Beata Michalska <beata.michalska@xxxxxxx>
> ---
>  Documentation/scheduler/sched-capacity.rst | 6 ++++--
>  Documentation/scheduler/sched-energy.rst   | 2 +-
>  2 files changed, 5 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/scheduler/sched-capacity.rst b/Documentation/scheduler/sched-capacity.rst
> index 9b7cbe4..92d16e7 100644
> --- a/Documentation/scheduler/sched-capacity.rst
> +++ b/Documentation/scheduler/sched-capacity.rst
> @@ -284,8 +284,10 @@ whether the system exhibits asymmetric CPU capacities. Should that be the
>  case:
>  
>  - The sched_asym_cpucapacity static key will be enabled.
> -- The SD_ASYM_CPUCAPACITY flag will be set at the lowest sched_domain level that
> -  spans all unique CPU capacity values.
> +- The SD_ASYM_CPUCAPACITY_FULL flag will be set at the lowest sched_domain
> +  level that spans all unique CPU capacity values.
> +- The SD_ASYM_CPUCAPACITY flag will be set for any sched_domain that spans
> +  cpus with any range of asymmetry.

     CPUs
please.

>  
>  The sched_asym_cpucapacity static key is intended to guard sections of code that
>  cater to asymmetric CPU capacity systems. Do note however that said key is
> diff --git a/Documentation/scheduler/sched-energy.rst b/Documentation/scheduler/sched-energy.rst
> index afe02d3..8fbce5e 100644
> --- a/Documentation/scheduler/sched-energy.rst
> +++ b/Documentation/scheduler/sched-energy.rst
> @@ -328,7 +328,7 @@ section lists these dependencies and provides hints as to how they can be met.
>  
>  As mentioned in the introduction, EAS is only supported on platforms with
>  asymmetric CPU topologies for now. This requirement is checked at run-time by
> -looking for the presence of the SD_ASYM_CPUCAPACITY flag when the scheduling
> +looking for the presence of the SD_ASYM_CPUCAPACITY_FULL flag when the scheduling
>  domains are built.
>  
>  See Documentation/scheduler/sched-capacity.rst for requirements to be met for this
> 

thanks.
-- 
~Randy