Skip to content

Commit c7461cc

Browse files
shashank-mahadasyamhtejun
authored andcommitted
cgroup, docs: Be explicit about independence of RT_GROUP_SCHED and non-cpu controllers
The cgroup v2 cpu controller has a limitation that if CONFIG_RT_GROUP_SCHED is enabled, the cpu controller can be enabled only if all the realtime processes are in the root cgroup. The other controllers have no such restriction. They can be used for the resource control of realtime processes irrespective of whether CONFIG_RT_GROUP_SCHED is enabled or not. Signed-off-by: Shashank Balaji <[email protected]> Acked-by: Waiman Long <[email protected]> Acked-by: Michal Koutný <[email protected]> Signed-off-by: Tejun Heo <[email protected]>
1 parent c4af66a commit c7461cc

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

Documentation/admin-guide/cgroup-v2.rst

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1075,15 +1075,20 @@ cpufreq governor about the minimum desired frequency which should always be
10751075
provided by a CPU, as well as the maximum desired frequency, which should not
10761076
be exceeded by a CPU.
10771077

1078-
WARNING: cgroup2 doesn't yet support control of realtime processes. For
1079-
a kernel built with the CONFIG_RT_GROUP_SCHED option enabled for group
1080-
scheduling of realtime processes, the cpu controller can only be enabled
1081-
when all RT processes are in the root cgroup. This limitation does
1082-
not apply if CONFIG_RT_GROUP_SCHED is disabled. Be aware that system
1083-
management software may already have placed RT processes into nonroot
1084-
cgroups during the system boot process, and these processes may need
1085-
to be moved to the root cgroup before the cpu controller can be enabled
1086-
with a CONFIG_RT_GROUP_SCHED enabled kernel.
1078+
WARNING: cgroup2 cpu controller doesn't yet fully support the control of
1079+
realtime processes. For a kernel built with the CONFIG_RT_GROUP_SCHED option
1080+
enabled for group scheduling of realtime processes, the cpu controller can only
1081+
be enabled when all RT processes are in the root cgroup. Be aware that system
1082+
management software may already have placed RT processes into non-root cgroups
1083+
during the system boot process, and these processes may need to be moved to the
1084+
root cgroup before the cpu controller can be enabled with a
1085+
CONFIG_RT_GROUP_SCHED enabled kernel.
1086+
1087+
With CONFIG_RT_GROUP_SCHED disabled, this limitation does not apply and some of
1088+
the interface files either affect realtime processes or account for them. See
1089+
the following section for details. Only the cpu controller is affected by
1090+
CONFIG_RT_GROUP_SCHED. Other controllers can be used for the resource control of
1091+
realtime processes irrespective of CONFIG_RT_GROUP_SCHED.
10871092

10881093

10891094
CPU Interface Files

0 commit comments

Comments
 (0)