man: describe how cgroup controllers are turned on
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Tue, 7 Mar 2023 15:02:14 +0000 (16:02 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Tue, 7 Mar 2023 15:22:13 +0000 (16:22 +0100)
commit253d0d591bdca605c9a775e22407f9ae80003234
tree2659ef26bb4093e38082ce37805f9dd3020a586a
parent87291a26f5262c47bdb3493d15534c18f25870e6
man: describe how cgroup controllers are turned on

For a user, information which cgroup controllers are enabled based on
the unit configuration is rather important. Not only because it determines
what resource control is peformed by the kernel, but also because controllers
have a non-negligible cost, especially for deep nesting, and users may want
to *not* have controllers enabled.

Our documentation did its best to avoid the topic so far. This was partially
caused by the support for cgroup v1, which meant that any discussion of
controllers had to be conditional and messy. But v1 is deprecated on its way
out, so it should be fine to just describe what happens with v2.

The text is extended with a discussion of how controllers are enabled and
disabled, and an example, and for various settings that enable controllers
the relevant controller is now mentioned.
man/systemd.resource-control.xml