summaryrefslogtreecommitdiffstats
path: root/man/homectl.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2020-09-21 18:25:46 +0200
committerLennart Poettering <lennart@poettering.net>2020-09-30 14:37:52 +0200
commitd1f6e01e4743ae94740314eeb46a162112ef4599 (patch)
treedcf2a1d9ea84f17554b398f04b522179c624932e /man/homectl.xml
parentMerge pull request #17203 from poettering/resolv-conf-mode (diff)
downloadsystemd-d1f6e01e4743ae94740314eeb46a162112ef4599.tar.xz
systemd-d1f6e01e4743ae94740314eeb46a162112ef4599.zip
homed: explicitly deactivate all home directories on shutdown
Let's explicitly deactivate all home dirs on shutdown, in order to properly synchronizing unmounting and avoiding blocking devices. Previously, we'd rely on automatic deactivation when home directories become unused. However, that scheme is asynchronous, and ongoing deactviations might conflicts with attempts to unmount /home. Let's fix that by providing an explicit service systemd-homed-activate.service whose only job is to have a ExecStop= line that explicitly deactivates all home directories on shutdown. This service can the be ordered after home.mount and similar, ensuring that we'll first deactivate all homes before deactivating /home itself during shutdown. This is kept separate from systemd-homed.service so that it is possible to restart systemd-homed.service without deactivating all home directories. Fixes: #16842
Diffstat (limited to 'man/homectl.xml')
-rw-r--r--man/homectl.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/man/homectl.xml b/man/homectl.xml
index 2ceb56e3f0..23eaedd6c5 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -822,6 +822,15 @@
</varlistentry>
<varlistentry>
+ <term><command>deactivate-all</command></term>
+
+ <listitem><para>Execute the <command>deactivate</command> command on all active home directories at
+ once. This operation is generally executed on system shut down (i.e. by <command>systemctl
+ poweroff</command> and related commands), to ensure all active user's home directories are fully
+ deactivated before <filename>/home/</filename> and related file systems are unmounted.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><command>with</command> <replaceable>USER</replaceable> <replaceable>COMMAND…</replaceable></term>
<listitem><para>Activate the specified user's home directory, run the specified command (under the