diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
index 4edb1a25a88..313a49a9595 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.