Re: [PATCH v3 3/3] docs: cgroup-v1: clarify that domain levels are system-specific

From: Vincent Guittot
Date: Thu Apr 04 2024 - 08:32:17 EST


On Wed, 3 Apr 2024 at 15:28, Vitalii Bursov <vitaly@xxxxxxxxxx> wrote:
>
> Add a clarification that domain levels are system-specific
> and where to check for system details.
>
> Signed-off-by: Vitalii Bursov <vitaly@xxxxxxxxxx>

Acked-by: Vincent Guittot <vincent.guittot@xxxxxxxxxx>

> ---
> Documentation/admin-guide/cgroup-v1/cpusets.rst | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/admin-guide/cgroup-v1/cpusets.rst b/Documentation/admin-guide/cgroup-v1/cpusets.rst
> index 7d3415eea05d..f401af5e2f09 100644
> --- a/Documentation/admin-guide/cgroup-v1/cpusets.rst
> +++ b/Documentation/admin-guide/cgroup-v1/cpusets.rst
> @@ -568,7 +568,7 @@ on the next tick. For some applications in special situation, waiting
>
> The 'cpuset.sched_relax_domain_level' file allows you to request changing
> this searching range as you like. This file takes int value which
> -indicates size of searching range in levels ideally as follows,
> +indicates size of searching range in levels approximately as follows,
> otherwise initial value -1 that indicates the cpuset has no request.
>
> ====== ===========================================================
> @@ -581,6 +581,11 @@ otherwise initial value -1 that indicates the cpuset has no request.
> 5 search system wide [on NUMA system]
> ====== ===========================================================
>
> +Not all levels can be present and values can change depending on the
> +system architecture and kernel configuration. Check
> +/sys/kernel/debug/sched/domains/cpu*/domain*/ for system-specific
> +details.
> +
> The system default is architecture dependent. The system default
> can be changed using the relax_domain_level= boot parameter.
>
> --
> 2.20.1
>