X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.resource-control.xml;h=e91c260bf15d13c99fa8e9c3886d1085bb8e9fb0;hb=8aa209ee141b2314e9f1bb502a08c5129bcca3b1;hp=e923b6da867cf1363a13a725bb8e25174792b157;hpb=5556b5fe41173107a67dbe875fbd916a46e52a02;p=elogind.git
diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
index e923b6da8..e91c260bf 100644
--- a/man/systemd.resource-control.xml
+++ b/man/systemd.resource-control.xml
@@ -105,22 +105,60 @@ along with systemd; If not, see .
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.
+ contained in the same slice and for all its parent slices
+ and the units contained therein. The system default for this
+ setting maybe controlled with
+ DefaultCPUAccounting= in
+ systemd-system.conf5.
CPUShares=weight
+ StartupCPUShares=weight
- Assign the specified overall CPU time share weight to
- the processes executed. Takes an integer value. This
- controls the cpu.shares control group
+ Assign the specified CPU time share weight to the
+ processes executed. Those options take an integer value and
+ control the cpu.shares control group
attribute, which defaults to 1024. For details about this
control group attribute, see sched-design-CFS.txt.
+ The available CPU time is split up among all units within
+ one slice relative to their CPU time share weight.
+
+ While StartupCPUShares= only
+ applies to the startup phase of the system,
+ CPUShares= applies to normal runtime of
+ the system, and if the former is not set also to the startup
+ phase. Using StartupCPUShares= allows
+ priorizing specific services at boot-up differently than
+ during normal runtime.
+
+ Those options imply
+ CPUAccounting=true.
+
+
+
+
+ CPUQuota=
+
+
+ Assign the specified CPU time quota to the processes
+ executed. Takes a percentage value, suffixed with "%". The
+ percentage specifies how much CPU time the unit shall get at
+ maximum, relative to the total CPU time available on one
+ CPU. Use values > 100% for alloting CPU time on more than
+ one CPU. This controls the
+ cpu.cfs_quota_us control group
+ attribute. For details about this control group attribute,
+ see sched-design-CFS.txt.
+ Example: CPUShares=20% ensures that
+ the executed processes will never get more than 20% CPU time
+ on one CPU.
+
Implies CPUAccounting=true.
@@ -132,8 +170,10 @@ along with systemd; If not, see .
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.
+ all its parent slices. The system default for this setting
+ maybe controlled with
+ DefaultMemoryAccounting= in
+ systemd-system.conf5.
@@ -164,26 +204,34 @@ along with systemd; If not, see .
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.
+ contained in the same slice and all for its parent slices
+ and the units contained therein. The system default for this
+ setting maybe controlled with
+ DefaultBlockIOAccounting= in
+ systemd-system.conf5.
BlockIOWeight=weight
-
- Set the default
- overall block IO weight for the
- executed processes. Takes a single
- weight value (between 10 and 1000) to
- set the default block IO weight. This
- controls the
- blkio.weight
- control group attribute, which
- defaults to 1000. For details about
- this control group attribute, see
- blkio-controller.txt.
+ StartupBlockIOWeight=weight
+
+ Set the default overall block IO weight for
+ the executed processes. Takes a single weight value (between
+ 10 and 1000) to set the default block IO weight. This controls
+ the blkio.weight control group attribute,
+ which defaults to 1000. For details about this control group
+ attribute, see blkio-controller.txt.
+ The available IO bandwidth is split up among all units within
+ one slice relative to their block IO weight.
+
+ While StartupBlockIOWeight= only
+ applies to the startup phase of the system,
+ BlockIOWeight= applies to the later runtime
+ of the system, and if the former is not set also to the
+ startup phase. This allows priorizing specific services at
+ boot-up differently than during runtime.
Implies
BlockIOAccounting=true.
@@ -267,12 +315,16 @@ along with systemd; If not, see .
followed by a device group name, as listed in
/proc/devices. The latter is useful to
whitelist all current and future devices belonging to a
- specific device group at once. Examples:
- /dev/sda5 is a path to a device node,
- referring to an ATA or SCSI block
+ specific device group at once. The device group is matched
+ according to file name globbing rules, you may hence use the
+ * and ?
+ wildcards. Examples: /dev/sda5 is a
+ path to a device node, referring to an ATA or SCSI block
device. char-pts and
char-alsa are specifiers for all pseudo
- TTYs and all ALSA sound devices, respectively.
+ TTYs and all ALSA sound devices,
+ respectively. char-cpu/* is a specifier
+ matching all CPU related device groups.