2024-04-03 13:31:20

by Vitalii Bursov

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

Add a clarification that domain levels are system-specific
and where to check for system details.

Signed-off-by: Vitalii Bursov <[email protected]>
---
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



2024-04-04 12:58:41

by Vincent Guittot

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

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

Acked-by: Vincent Guittot <[email protected]>

> ---
> 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
>

2024-04-04 14:39:29

by Valentin Schneider

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

On 03/04/24 16:28, Vitalii Bursov wrote:
> Add a clarification that domain levels are system-specific
> and where to check for system details.
>
> Signed-off-by: Vitalii Bursov <[email protected]>

Reviewed-by: Valentin Schneider <[email protected]>