From a1de7d01ff10fc87010496d9c776e0df68e71214 Mon Sep 17 00:00:00 2001
From: Lucas Werkmeister <mail@lucaswerkmeister.de>
Date: Sun, 3 Jan 2021 14:44:21 +0100
Subject: [PATCH] man: systemd-sysusers does not create home dir
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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.)
---
 man/sysusers.d.xml | 5 +++++
 1 file changed, 5 insertions(+)

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>