From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 16 Nov 2017 03:00:56 +0000 (+0100)
Subject: man: document interaction of --root= and the user/group databases (#7344)
X-Git-Tag: v236~207
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3e54b900e6a50770eae14e00b9f483955db78396;p=thirdparty%2Fsystemd.git

man: document interaction of --root= and the user/group databases (#7344)

Fixes: #7032
---

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index c1aab515517..2b8927cb1ef 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -148,12 +148,16 @@
         specified prefix. This option can be specified multiple
         times.</para></listitem>
       </varlistentry>
+
       <varlistentry>
         <term><option>--root=<replaceable>root</replaceable></option></term>
-        <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></listitem>
+        <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>
       </varlistentry>
 
       <xi:include href="standard-options.xml" xpointer="help" />