Skip to content

Commit 20d4628

Browse files
Waiman-Longhtejun
authored andcommitted
cgroup, docs: Clarify limitation of RT processes with cgroup v2 cpu controller
The limitation that all RT processes have to be in the root cgroup before enabling cpu controller only applies if the CONFIG_RT_GROUP_SCHED option is enabled in the running kernel. If a kernel does not have CONFIG_RT_GROUP_SCHED enabled, RT processes can exist in a non-root cgroup even when cpu controller is enabled. CPU sharing of RT processes will not be under cgroup control, but other resources like memory can be. Clarify this limitation to avoid confusion to users that are using cgroup v2. Signed-off-by: Waiman Long <[email protected]> Signed-off-by: Tejun Heo <[email protected]>
1 parent 4cece76 commit 20d4628

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

Documentation/admin-guide/cgroup-v2.rst

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1058,12 +1058,15 @@ cpufreq governor about the minimum desired frequency which should always be
10581058
provided by a CPU, as well as the maximum desired frequency, which should not
10591059
be exceeded by a CPU.
10601060

1061-
WARNING: cgroup2 doesn't yet support control of realtime processes and
1062-
the cpu controller can only be enabled when all RT processes are in
1063-
the root cgroup. Be aware that system management software may already
1064-
have placed RT processes into nonroot cgroups during the system boot
1065-
process, and these processes may need to be moved to the root cgroup
1066-
before the cpu controller can be enabled.
1061+
WARNING: cgroup2 doesn't yet support control of realtime processes. For
1062+
a kernel built with the CONFIG_RT_GROUP_SCHED option enabled for group
1063+
scheduling of realtime processes, the cpu controller can only be enabled
1064+
when all RT processes are in the root cgroup. This limitation does
1065+
not apply if CONFIG_RT_GROUP_SCHED is disabled. Be aware that system
1066+
management software may already have placed RT processes into nonroot
1067+
cgroups during the system boot process, and these processes may need
1068+
to be moved to the root cgroup before the cpu controller can be enabled
1069+
with a CONFIG_RT_GROUP_SCHED enabled kernel.
10671070

10681071

10691072
CPU Interface Files

0 commit comments

Comments
 (0)