X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsystemd.swap.xml;h=c4160290a5142787f38c00cf9c95c7a0fa0d8efc;hb=6dbf40256bd88f1c74657bd9ffbd9eaa06c08706;hp=cf4e1ba8398584ef1c9f7e2fc390a914729104e3;hpb=f5df066d1d28920e49cf03d5950330138ea4f236;p=thirdparty%2Fsystemd.git diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml index cf4e1ba8398..c4160290a51 100644 --- a/man/systemd.swap.xml +++ b/man/systemd.swap.xml @@ -1,39 +1,14 @@ - + - - - systemd.swap systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - @@ -62,15 +37,15 @@ this unit type. See systemd.unit5 for the common options of all unit configuration files. The common - configuration items are configured in the generic [Unit] and - [Install] sections. The swap specific configuration options are - configured in the [Swap] section. + configuration items are configured in the generic [Unit] and + [Install] sections. The swap specific configuration options are + configured in the [Swap] section. Additional options are listed in systemd.exec5, which define the execution environment the swapon8 - binary is executed in, in + program is executed in, in systemd.kill5, which define the way these processes are terminated, and in @@ -79,7 +54,7 @@ unit. Swap units must be named after the devices or files they control. Example: the swap device /dev/sda5 must be configured in a unit file dev-sda5.swap. For + index="false">/dev/sda5 must be configured in a unit file dev-sda5.swap. For details about the escaping logic used to convert a file system path to a unit name, see systemd.unit5. Note that swap units cannot be templated, nor is possible to add multiple names to a swap unit by creating additional symlinks to @@ -89,21 +64,36 @@ Automatic Dependencies - All swap units automatically get the - BindsTo= and After= - dependencies on the device units or the mount units of the files - they are activated from. + + Implicit Dependencies - Swap units with DefaultDependencies= in the [Unit] section enabled - implicitly acquire a Conflicts= and an After= dependency on - umount.target so that they are deactivated at shutdown, unless - DefaultDependencies=no is specified. + The following dependencies are implicitly added: - Additional implicit dependencies may be added as result of - execution and resource control parameters as documented in - systemd.exec5 - and - systemd.resource-control5. + + All swap units automatically get the + BindsTo= and After= + dependencies on the device units or the mount units of the files + they are activated from. + + + Additional implicit dependencies may be added as result of + execution and resource control parameters as documented in + systemd.exec5 + and + systemd.resource-control5. + + + + Default Dependencies + + The following dependencies are added unless DefaultDependencies=no is set: + + + Swap units automatically acquire a Conflicts= and a + Before= dependency on umount.target so that they are deactivated at + shutdown as well as a Before=swap.target dependency. + + @@ -150,6 +140,26 @@ successfully. + + + + + + + The swap structure will be initialized on the device. If the device is not + "empty", i.e. it contains any signature, the operation will be skipped. It is hence expected + that this option remains set even after the device has been initialized. + + Note that this option can only be used in /etc/fstab, and will be + ignored when part of the Options= setting in a unit file. + + See + systemd-mkswap@.service8 + and the discussion of + wipefs8 + in systemd.mount5. + + @@ -170,17 +180,17 @@ What= - Takes an absolute path of a device node or - file to use for paging. See - swapon8 - for details. If this refers to a device node, a dependency on - the respective device unit is automatically created. (See + Takes an absolute path of a device node or file to use for paging. See swapon8 for + details. If this refers to a device node, a dependency on the respective device unit is automatically + created. (See systemd.device5 - for more information.) If this refers to a file, a dependency - on the respective mount unit is automatically created. (See - systemd.mount5 - for more information.) This option is - mandatory. + for more information.) If this refers to a file, a dependency on the respective mount unit is + automatically created. (See + systemd.mount5 for + more information.) This option is mandatory. Note that the usual specifier expansion is applied to + this setting, literal percent characters should hence be written as + %%. @@ -195,12 +205,11 @@ Options= - May contain an option string for the swap - device. This may be used for controlling discard options among - other functionality, if the swap backing device supports the - discard or trim operation. (See + May contain an option string for the swap device. This may be used for controlling discard + options among other functionality, if the swap backing device supports the discard or trim operation. (See swapon8 - for more information.) + for more information.) Note that the usual specifier expansion is applied to this setting, literal percent + characters should hence be written as %%. @@ -235,6 +244,7 @@ systemd1, systemctl1, + systemd-system.conf5, systemd.unit5, systemd.exec5, systemd.kill5,