summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2021-04-09 09:27:42 +0200
committerLennart Poettering <lennart@poettering.net>2021-04-09 10:38:09 +0200
commit5c91fdf3f832a45db35b207da650c4aa12fafa75 (patch)
tree82329301f19d0c278756be8f49e84bb4c486050d
parent276dc7af748ea4dda9fbf1e7d35bc80057b55177 (diff)
downloadsystemd-5c91fdf3f832a45db35b207da650c4aa12fafa75.tar.gz
man: document system-systemd\x2dcryptsetup.slice
As discussed in https://github.com/systemd/systemd/pull/14235/commits/1dc85eff1d0dff18aaeaae530c91bf53f34b726e#r606821495, follow-up for commit 1dc85eff1d0dff18aaeaae530c91bf53f34b726e.
-rw-r--r--man/systemd-cryptsetup@.service.xml15
-rw-r--r--units/system-systemd\x2dcryptsetup.slice2
2 files changed, 12 insertions, 5 deletions
diff --git a/man/systemd-cryptsetup@.service.xml b/man/systemd-cryptsetup@.service.xml
index c70d6a9d3e..668208a01d 100644
--- a/man/systemd-cryptsetup@.service.xml
+++ b/man/systemd-cryptsetup@.service.xml
@@ -17,22 +17,29 @@
<refnamediv>
<refname>systemd-cryptsetup@.service</refname>
+ <!-- <refname>system-systemd\x2dcryptsetup.slice</refname> — this causes meson to go haywire because it
+ thinks this is a (windows) path. Let's just not create the alias for this name, and only include it
+ in the synopsis. -->
<refname>systemd-cryptsetup</refname>
<refpurpose>Full disk decryption logic</refpurpose>
</refnamediv>
<refsynopsisdiv>
<para><filename>systemd-cryptsetup@.service</filename></para>
+ <para><filename>system-systemd\x2dcryptsetup.slice</filename></para>
<para><filename>/usr/lib/systemd/systemd-cryptsetup</filename></para>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
- <para><filename>systemd-cryptsetup@.service</filename> is a
- service responsible for setting up encrypted block devices. It is
- instantiated for each device that requires decryption for
- access.</para>
+ <para><filename>systemd-cryptsetup@.service</filename> is a service responsible for setting up encrypted
+ block devices. It is instantiated for each device that requires decryption for access.</para>
+
+ <para><filename>systemd-cryptsetup@.service</filename> instances are part of the
+ <filename>system-systemd\x2dcryptsetup.slice</filename> slice, which is destroyed only very late in the
+ shutdown procedure. This allows the encrypted devices to remain up until filesystems have been unmounted.
+ </para>
<para><filename>systemd-cryptsetup@.service</filename> will ask
for hard disk passwords via the <ulink
diff --git a/units/system-systemd\x2dcryptsetup.slice b/units/system-systemd\x2dcryptsetup.slice
index 9369b73ae2..98206a9d06 100644
--- a/units/system-systemd\x2dcryptsetup.slice
+++ b/units/system-systemd\x2dcryptsetup.slice
@@ -9,5 +9,5 @@
[Unit]
Description=Cryptsetup Units Slice
-Documentation=man:systemd.special(7)
+Documentation=man:systemd-cryptsetup@.service(8)
DefaultDependencies=no