X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.cgroup.xml;h=cc0eb15abb901976db4a2641ab3c793489c7128f;hp=e31faf522e698c343c295f76bc962dc32969941a;hb=68eda4bd168306f51c90e5d22824c494d709289e;hpb=6a75304e41e4487d840057a0e5f9972e141e4540 diff --git a/man/systemd.cgroup.xml b/man/systemd.cgroup.xml index e31faf522..cc0eb15ab 100644 --- a/man/systemd.cgroup.xml +++ b/man/systemd.cgroup.xml @@ -44,7 +44,7 @@ along with systemd; If not, see . systemd.cgroup - Cgroup configuration unit settings + Control Group configuration unit settings @@ -66,6 +66,10 @@ along with systemd; If not, see . configuration options which configure the control group settings for spawned processes. + Control Groups is a concept for organizing processes in a + hierarch tree of named groups for the purpose of resource + management. + This man page lists the configuration options shared by those six unit types. See systemd.unit5 @@ -90,34 +94,19 @@ along with systemd; If not, see . for cgroup configuration: - - CPUAccounting= - - - Turn on CPU usage accounting for this - unit. - - - BlockIOAccounting= - - - Turn on Block IO bandwidth accounting - for this unit. - - - - - MemoryAccounting= + CPUAccounting= - Turn on process and kernel memory - accounting for this unit. + Turn on CPU usage accounting for this unit. Takes a + boolean argument. Note that turning on CPU accounting for + one unit might also implicitly turn it on for all units + contained in the same slice and for all its parent slices and + the units contained therein. - CPUShares=weight @@ -127,12 +116,24 @@ along with systemd; If not, see . controls the cpu.shares control group attribute, which defaults to 1024. For details about this control group attribute, see sched-design-CFS.txt. + url="https://www.kernel.org/doc/Documentation/scheduler/sched-design-CFS.txt">sched-design-CFS.txt. Implies CPUAccounting=true. + + MemoryAccounting= + + + Turn on process and kernel memory accounting for this + unit. Takes a boolean argument. Note that turning on memory + accounting for one unit might also implicitly turn it on for + all units contained in the same slice and for all its parent + slices and the units contained therein. + + + MemoryLimit=bytes MemorySoftLimit=bytes @@ -152,12 +153,24 @@ along with systemd; If not, see . memory.soft_limit_in_bytes control group attributes. For details about these control group attributes, see memory.txt. + url="https://www.kernel.org/doc/Documentation/cgroups/memory.txt">memory.txt. Implies MemoryAccounting=true. + + BlockIOAccounting= + + + Turn on Block IO accounting for this unit. Takes a + boolean argument. Note that turning on block IO accounting + for one unit might also implicitly turn it on for all units + contained in the same slice and all for its parent slices and + the units contained therein. + + + BlockIOWeight=weight @@ -172,7 +185,11 @@ along with systemd; If not, see . defaults to 1000. For details about this control group attribute, see blkio-controller.txt. + url="https://www.kernel.org/doc/Documentation/cgroups/blkio-controller.txt">blkio-controller.txt. + + Implies + BlockIOAccounting=true. + @@ -191,7 +208,10 @@ along with systemd; If not, see . attribute, which defaults to 1000. Use this option multiple times to set weights for multiple devices. For details about this control group attribute, see blkio-controller.txt. + url="https://www.kernel.org/doc/Documentation/cgroups/blkio-controller.txt">blkio-controller.txt. + + Implies + BlockIOAccounting=true. @@ -215,8 +235,11 @@ along with systemd; If not, see . attributes. Use this option multiple times to set bandwidth limits for multiple devices. For details about these control group attributes, see - blkio-controller.txt. + blkio-controller.txt. + + Implies + BlockIOAccounting=true. @@ -236,7 +259,7 @@ along with systemd; If not, see . devices.deny control group attributes. For details about these control group attributes, see devices.txt. + url="https://www.kernel.org/doc/Documentation/cgroups/devices.txt">devices.txt. @@ -283,6 +306,29 @@ along with systemd; If not, see . + + + Slice= + + + The name of the slice unit to place the unit + in. Defaults to system.slice for all + non-instantiated units of all unit types (except for slice + units themselves see below). Instance units are by default + placed in a subslice of system.slice + that is named after the template name. + + This option may be used to arrange systemd units in a + hierarchy of slices each of which might have resource + settings applied. + + For units of type slice, the only accepted value for + this setting is the parent slice. Since the name of a slice + unit implies the parent slice, it is hence redundant to ever + set this parameter directly for slice units. + + + @@ -298,11 +344,12 @@ along with systemd; If not, see . systemd.mount5, systemd.swap5, systemd.directives7, + systemd.special7, The documentation for control groups and specific controllers in the Linux kernel: - cgroups.txt, - cpuacct.txt, - memory.txt, - blkio-controller.txt. + cgroups.txt, + cpuacct.txt, + memory.txt, + blkio-controller.txt.