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

1 files changed, 6 insertions, 0 deletions

diff --git a/man/org.freedesktop.home1.xml b/man/org.freedesktop.home1.xml
index 73f8682480..8d3defbfe0 100644
--- a/man/org.freedesktop.home1.xml
+++ b/man/org.freedesktop.home1.xml
@@ -95,6 +95,7 @@ node /org/freedesktop/home1 {
               out h send_fd);
       ReleaseHome(in  s user_name);
       LockAllHomes();
+      DeactivateAllHomes();
     properties:
       readonly a(sso) AutoLogin = [...];
   };
@@ -156,6 +157,8 @@ node /org/freedesktop/home1 {
 
     <variablelist class="dbus-method" generated="True" extra-ref="LockAllHomes()"/>
 
+    <variablelist class="dbus-method" generated="True" extra-ref="DeactivateAllHomes()"/>
+
     <variablelist class="dbus-property" generated="True" extra-ref="AutoLogin"/>
 
     <!--End of Autogenerated section-->
@@ -340,6 +343,9 @@ node /org/freedesktop/home1 {
       <para><function>LockAllHomes()</function> locks all active home directories that only have references
       that opted into automatic suspending during system suspend. This is usually invoked automatically
       shortly before system suspend.</para>
+
+      <para><function>DeactivateAllHomes()</function> deactivates all home areas that are currently
+      active. This is usually invoked automatically shortly before system shutdown.</para>
     </refsect2>
 
     <refsect2>