summaryrefslogtreecommitdiff
path: root/man/sysusers.d.xml
diff options
context:
space:
mode:
authorLucas Werkmeister <mail@lucaswerkmeister.de>2021-01-03 14:44:21 +0100
committerLennart Poettering <lennart@poettering.net>2021-01-03 22:51:07 +0100
commita1de7d01ff10fc87010496d9c776e0df68e71214 (patch)
tree48814c587b32411cf3f9ecd713bc4e77b5745e8a /man/sysusers.d.xml
parent612a6869eee4747945c757ed04f97a87ee3a2f08 (diff)
downloadsystemd-a1de7d01ff10fc87010496d9c776e0df68e71214.tar.gz
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.)
Diffstat (limited to 'man/sysusers.d.xml')
-rw-r--r--man/sysusers.d.xml5
1 files changed, 5 insertions, 0 deletions
diff --git a/man/sysusers.d.xml b/man/sysusers.d.xml
index a76dda954b..e15c1b2eee 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>