From 0069a0dd1431ea5de075f3c6405e2b33abab8351 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Mon, 16 May 2016 22:48:45 +0200 Subject: man: clarify that IOXyz= only applies to the unified hierarchy, and BlockIOXyz= to the legacy hierarchy With this change for each setting we say which hierarachy it applies to briefly in the first sentence of the description, plus in longer form in an extra pargraph at the end, with a recommendation for the counterpart of the option in the other hierarchy. Also adds markup and the "=" suffix to all mentioned settings. --- man/systemd.resource-control.xml | 182 ++++++++++++++++++--------------------- 1 file changed, 84 insertions(+), 98 deletions(-) (limited to 'man/systemd.resource-control.xml') diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml index 4edb1a25a8..313a49a959 100644 --- a/man/systemd.resource-control.xml +++ b/man/systemd.resource-control.xml @@ -252,14 +252,15 @@ IOAccounting= - Turn on Block I/O accounting for this unit on unified - hierarchy. Takes a boolean argument. Note that turning on - block I/O accounting for one unit will also implicitly turn - it on for all units contained in the same slice and all for - its parent slices and the units contained therein. The - system default for this setting may be controlled with - DefaultIOAccounting= in + Turn on Block I/O accounting for this unit, if the unified control group hierarchy is used on the + system. Takes a boolean argument. Note that turning on block I/O accounting for one unit will also implicitly + turn it on for all units contained in the same slice and all for its parent slices and the units contained + therein. The system default for this setting may be controlled with DefaultIOAccounting= + in systemd-system.conf5. + + This setting is supported only if the unified control group hierarchy is used. Use + BlockIOAccounting= on systems using the legacy control group hierarchy. @@ -268,15 +269,12 @@ StartupIOWeight=weight - Set the default overall block I/O weight for the - executed processes on unified hierarchy. Takes a single - weight value (between 1 and 10000) to set the default block - I/O weight. This controls the io.weight - control group attribute, which defaults to 100. For details - about this control group attribute, see cgroup-v2.txt. - The available I/O bandwidth is split up among all units - within one slice relative to their block I/O weight. + Set the default overall block I/O weight for the executed processes, if the unified control group + hierarchy is used on the system. Takes a single weight value (between 1 and 10000) to set the default block + I/O weight. This controls the io.weight control group attribute, which defaults to + 100. For details about this control group attribute, see cgroup-v2.txt. The available I/O + bandwidth is split up among all units within one slice relative to their block I/O weight. While StartupIOWeight= only applies to the startup phase of the system, @@ -286,6 +284,10 @@ differently than during runtime. Implies IOAccounting=true. + + This setting is supported only if the unified control group hierarchy is used. Use + BlockIOWeight= and StartupBlockIOWeight= on systems using the legacy + control group hierarchy. @@ -293,21 +295,19 @@ IODeviceWeight=device weight - Set the per-device overall block I/O weight for the - executed processes on unified hierarchy. Takes a - space-separated pair of a file path and a weight value to - specify the device specific weight value, between 1 and - 10000. (Example: "/dev/sda 1000"). The file path may be - specified as path to a block device node or as any other - file, in which case the backing block device of the file - system of the file is determined. This controls the - io.weight control group attribute, which - defaults to 100. Use this option multiple times to set - weights for multiple devices. For details about this control - group attribute, see Set the per-device overall block I/O weight for the executed processes, if the unified control group + hierarchy is used on the system. Takes a space-separated pair of a file path and a weight value to specify + the device specific weight value, between 1 and 10000. (Example: "/dev/sda 1000"). The file path may be + specified as path to a block device node or as any other file, in which case the backing block device of the + file system of the file is determined. This controls the io.weight control group + attribute, which defaults to 100. Use this option multiple times to set weights for multiple devices. For + details about this control group attribute, see cgroup-v2.txt. Implies IOAccounting=true. + + This setting is supported only if the unified control group hierarchy is used. Use + BlockIODeviceWeight= on systems using the legacy control group hierarchy. @@ -316,27 +316,23 @@ IOWriteBandwidthMax=device bytes - Set the per-device overall block I/O bandwidth maximum - limit for the executed processes on unified hierarchy. This - limit is not work-conserving and the executed processes are - not allowed to use more even if the device has idle - capacity. Takes a space-separated pair of a file path and a - bandwidth value (in bytes per second) to specify the device - specific bandwidth. The file path may be a path to a block - device node, or as any other file in which case the backing - block device of the file system of the file is used. If the - bandwidth is suffixed with K, M, G, or T, the specified - bandwidth is parsed as Kilobytes, Megabytes, Gigabytes, or - Terabytes, respectively, to the base of 1000. (Example: - "/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 5M"). This - controls the io.max control group - attributes. Use this option multiple times to set bandwidth - limits for multiple devices. For details about this control - group attribute, see Set the per-device overall block I/O bandwidth maximum limit for the executed processes, if the unified + control group hierarchy is used on the system. This limit is not work-conserving and the executed processes + are not allowed to use more even if the device has idle capacity. Takes a space-separated pair of a file + path and a bandwidth value (in bytes per second) to specify the device specific bandwidth. The file path may + be a path to a block device node, or as any other file in which case the backing block device of the file + system of the file is used. If the bandwidth is suffixed with K, M, G, or T, the specified bandwidth is + parsed as Kilobytes, Megabytes, Gigabytes, or Terabytes, respectively, to the base of 1000. (Example: + "/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 5M"). This controls the io.max control + group attributes. Use this option multiple times to set bandwidth limits for multiple devices. For details + about this control group attribute, see cgroup-v2.txt. Implies IOAccounting=true. + + This setting is supported only if the unified control group hierarchy is used. Use + BlockIOAccounting= on systems using the legacy control group hierarchy. @@ -344,16 +340,15 @@ BlockIOAccounting= - Use IOAccounting on unified hierarchy. - - Turn on Block I/O accounting for this unit. Takes a - boolean argument. Note that turning on block I/O accounting - for one unit will also implicitly turn it on for all units - contained in the same slice and all for its parent slices - and the units contained therein. The system default for this - setting may be controlled with + Turn on Block I/O accounting for this unit, if the legacy control group hierarchy is used on the + system. Takes a boolean argument. Note that turning on block I/O accounting for one unit will also implicitly + turn it on for all units contained in the same slice and all for its parent slices and the units contained + therein. The system default for this setting may be controlled with DefaultBlockIOAccounting= in systemd-system.conf5. + + This setting is supported only if the legacy control group hierarchy is used. Use + IOAccounting= on systems using the unified control group hierarchy. @@ -361,18 +356,13 @@ BlockIOWeight=weight StartupBlockIOWeight=weight - Use IOWeight and StartupIOWeight on unified - hierarchy. - - Set the default overall block I/O weight for the - executed processes. Takes a single weight value (between 10 - and 1000) to set the default block I/O weight. This controls - the blkio.weight control group attribute, - which defaults to 500. For details about this control group - attribute, see Set the default overall block I/O weight for the executed processes, if the legacy control + group hierarchy is used on the system. Takes a single weight value (between 10 and 1000) to set the default + block I/O weight. This controls the blkio.weight control group attribute, which defaults to + 500. For details about this control group attribute, see blkio-controller.txt. - The available I/O bandwidth is split up among all units within - one slice relative to their block I/O weight. + The available I/O bandwidth is split up among all units within one slice relative to their block I/O + weight. While StartupBlockIOWeight= only applies to the startup phase of the system, @@ -383,31 +373,32 @@ Implies BlockIOAccounting=true. - + + This setting is supported only if the legacy control group hierarchy is used. Use + IOWeight= and StartupIOWeight= on systems using the unified control group + hierarchy. + + BlockIODeviceWeight=device weight - Use IODeviceWeight on unified hierarchy. - - Set the per-device overall block I/O weight for the - executed processes. Takes a space-separated pair of a file - path and a weight value to specify the device specific - weight value, between 10 and 1000. (Example: "/dev/sda - 500"). The file path may be specified as path to a block - device node or as any other file, in which case the backing - block device of the file system of the file is - determined. This controls the - blkio.weight_device control group - attribute, which defaults to 1000. Use this option multiple - times to set weights for multiple devices. For details about - this control group attribute, see Set the per-device overall block I/O weight for the executed processes, if the legacy control group + hierarchy is used on the system. Takes a space-separated pair of a file path and a weight value to specify + the device specific weight value, between 10 and 1000. (Example: "/dev/sda 500"). The file path may be + specified as path to a block device node or as any other file, in which case the backing block device of the + file system of the file is determined. This controls the blkio.weight_device control group + 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. Implies BlockIOAccounting=true. + + This setting is supported only if the legacy control group hierarchy is used. Use + IODeviceWeight= on systems using the unified control group hierarchy. @@ -416,30 +407,25 @@ BlockIOWriteBandwidth=device bytes - Use IOReadBandwidthMax and IOWriteBandwidthMax on - unified hierarchy. - - Set the per-device overall block I/O bandwidth limit - for the executed processes. Takes a space-separated pair of - a file path and a bandwidth value (in bytes per second) to - specify the device specific bandwidth. The file path may be - a path to a block device node, or as any other file in which - case the backing block device of the file system of the file - is used. If the bandwidth is suffixed with K, M, G, or T, - the specified bandwidth is parsed as Kilobytes, Megabytes, - Gigabytes, or Terabytes, respectively, to the base of - 1000. (Example: - "/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 5M"). This - controls the blkio.throttle.read_bps_device and - blkio.throttle.write_bps_device control group - attributes. Use this option multiple times to set bandwidth - limits for multiple devices. For details about these control - group attributes, see Set the per-device overall block I/O bandwidth limit for the executed processes, if the legacy control + group hierarchy is used on the system. Takes a space-separated pair of a file path and a bandwidth value (in + bytes per second) to specify the device specific bandwidth. The file path may be a path to a block device + node, or as any other file in which case the backing block device of the file system of the file is used. If + the bandwidth is suffixed with K, M, G, or T, the specified bandwidth is parsed as Kilobytes, Megabytes, + Gigabytes, or Terabytes, respectively, to the base of 1000. (Example: + "/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0 5M"). This controls the + blkio.throttle.read_bps_device and blkio.throttle.write_bps_device + control group attributes. Use this option multiple times to set bandwidth limits for multiple devices. For + details about these control group attributes, see blkio-controller.txt. Implies BlockIOAccounting=true. + + This setting is supported only if the legacy control group hierarchy is used. Use + IOReadBandwidthMax= and IOWriteBandwidthMax= on systems using the + unified control group hierarchy. -- cgit v1.2.3-54-g00ecf