X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.swap.xml;h=ab00f9f3186251f3808bcca38865e4238a32c7e6;hb=21d279cf543c82705a5b3362818805603d2ab9f2;hp=18f96d008ff02d99925cf162f34f16ef66867cfe;hpb=b439c6ee04967fa988d232e0765f972cb27b1877;p=elogind.git
diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml
index 18f96d008..ab00f9f31 100644
--- a/man/systemd.swap.xml
+++ b/man/systemd.swap.xml
@@ -68,13 +68,23 @@
specific configuration options are configured in the
[Swap] section.
- Swap units must be named after the devices they
- control. Example: the swap device
+ Swap units must be named after the devices
+ (resp. files) they control. Example: the swap device
/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.
+
+ All swap units automatically get the appropriate
+ dependencies on the devices (resp. on the mount points
+ of the files) they are activated from.
+
+ Swap units with
+ DefaultDependencies= enabled
+ implicitly acquire a conflicting dependency to
+ umount.target so that they are
+ deactivated at shutdown.
@@ -88,6 +98,13 @@
If a swap device or file is configured in both
/etc/fstab and a unit file the
configuration in the latter takes precedence.
+
+ Unless the option is set
+ for them all swap units configured in
+ /etc/fstab are also added as
+ requirements to swap.target, so
+ that they are waited for and activated during
+ boot.
@@ -95,8 +112,12 @@
Swap files must include a [Swap] section, which
carries information about the swap device it
- supervises. The options specific to the [Swap] section
- of swap units are the following:
+ supervises. A number of options that may be used in
+ this section are shared with other unit types. These
+ options are documented in
+ systemd.exec5. The
+ options specific to the [Swap] section of swap units
+ are the following:
@@ -128,15 +149,70 @@
file. This takes an integer. This
setting is optional.
+
+
+ TimeoutSec=
+ Configures the time to
+ wait for the swapon command to
+ finish. If a command does not exit
+ within the configured time the swap
+ will be considered failed and be shut
+ down again. All commands still running
+ will be terminated forcibly via
+ SIGTERM, and after another delay of
+ this time with SIGKILL. (See
+ below.)
+ Takes a unit-less value in seconds, or
+ a time span value such as "5min
+ 20s". Pass 0 to disable the timeout
+ logic. Defaults to
+ 90s.
+
+
+
+ KillMode=
+ Specifies how
+ processes of this swap shall be
+ killed. One of
+ ,
+ ,
+ .
+
+ This option is mostly equivalent
+ to the
+ option of service files. See
+ systemd.service5
+ for details.
+
+
+
+ KillSignal=
+ Specifies which signal
+ to use when killing a process of this
+ swap. Defaults to SIGTERM.
+
+
+
+
+ SendSIGKILL=
+ Specifies whether to
+ send SIGKILL to remaining processes
+ after a timeout, if the normal
+ shutdown procedure left processes of
+ the swap around. Takes a boolean
+ value. Defaults to "yes".
+
+ See Also
- systemd8,
+ systemd1,
systemctl8,
systemd.unit5,
+ systemd.exec5,
systemd.device5,
systemd.mount5,
swapon8