cgroup, docs: document the root cgroup behavior of cpu and io controllers
authorMaciej S. Szmigiero <mail@maciej.szmigiero.name>
Wed, 10 Jan 2018 22:33:19 +0000 (23:33 +0100)
committerTejun Heo <tj@kernel.org>
Tue, 16 Jan 2018 16:07:09 +0000 (08:07 -0800)
commitc4e0842bf141178fd5bc0cfe364609ec782fb384
tree3d2b86166cf8d8b55214b40763478268ad4fc988
parent2877cbe6501e20dd076c7677f768d50bcc87267b
cgroup, docs: document the root cgroup behavior of cpu and io controllers

Currently, cgroups v2 documentation contains only a generic remark that
"How resource consumption in the root cgroup is governed is up to each
controller", which isn't really telling users much, who need to dig in the
code and / or commit messages to learn the exact behavior.

In cgroups v1 at least the blkio controller had its operation with respect
to competition between child threads and child cgroups documented in
blkio-controller.txt, with references to cfq-iosched.txt.
Also, cgroups v2 documentation describes v1 behavior of both cpu and
blkio controllers in an "Issues with v1" section.

Let's document this behavior also for cgroups v2 to make life easier for
users.

Signed-off-by: Maciej S. Szmigiero <mail@maciej.szmigiero.name>
Signed-off-by: Tejun Heo <tj@kernel.org>
Documentation/cgroup-v2.txt