Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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 <longman@redhat.com>
Signed-off-by: Tejun Heo <tj@kernel.org>

authored by

Waiman Long and committed by
Tejun Heo
20d46283 4cece764

+9 -6
+9 -6
Documentation/admin-guide/cgroup-v2.rst
··· 1058 1058 provided by a CPU, as well as the maximum desired frequency, which should not 1059 1059 be exceeded by a CPU. 1060 1060 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. 1067 1070 1068 1071 1069 1072 CPU Interface Files