From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 5 May 2020 21:23:00 +0000 (+0200)
Subject: man: document the new tmpfiles --root= behaviour regarding users
X-Git-Tag: v246-rc1~410^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F15718%2Fhead;p=thirdparty%2Fsystemd.git

man: document the new tmpfiles --root= behaviour regarding users
---

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 7720ef53fa1..998fd0911ba 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -161,10 +161,10 @@
         <listitem><para>Takes a directory path as an argument. All paths will be prefixed with the given alternate
         <replaceable>root</replaceable> path, including config search paths.</para>
 
-        <para>Note that this option does not alter how the users and groups specified in the configuration files are
-        resolved. With or without this option, users and groups are always resolved according to the host's user and
-        group databases, any such databases stored under the specified root directories are not
-        consulted.</para></listitem>
+        <para>When this option is used, the libc Name Service Switch (NSS) is bypassed for resolving users
+        and groups. Instead the files <filename>/etc/passwd</filename> and <filename>/etc/group</filename>
+        inside the alternate root are read directly. This means that users/groups not listed in these files
+        will not be resolved, i.e. LDAP NIS and other complex databases are not considered.</para></listitem>
       </varlistentry>
 
       <varlistentry>