From: Lucas Werkmeister <mail@lucaswerkmeister.de>
Date: Sun, 3 Jan 2021 13:44:21 +0000 (+0100)
Subject: man: systemd-sysusers does not create home dir
X-Git-Tag: v248-rc1~437
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a1de7d01ff10fc87010496d9c776e0df68e71214;p=thirdparty%2Fsystemd.git

man: systemd-sysusers does not create home dir

Document that systemd-sysusers doesn’t create the specified home
directory, and point to systemd-tmpfiles as the service that can create
the home directory instead. (systemd-tmpfiles-setup.service is ordered
After=systemd-sysusers.service, so by the time systemd-tmpfiles would
create the home directory, sysusers would have created the owning user
already, and it should all work out.)
---

diff --git a/man/sysusers.d.xml b/man/sysusers.d.xml
index a76dda954b1..e15c1b2eee5 100644
--- a/man/sysusers.d.xml
+++ b/man/sysusers.d.xml
@@ -216,6 +216,11 @@ r     -        500-900
       <para>Only applies to lines of type <varname>u</varname> and should otherwise
       be left unset (or <literal>-</literal>). It is recommended to omit this, unless
       software strictly requires a home directory to be set.</para>
+
+      <para><command>systemd-sysusers</command> only sets the home directory record in the
+      user database. To actually create the directory, consider adding a corresponding
+      <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+      fragment.</para>
     </refsect2>
 
     <refsect2>