From: Serge Hallyn <serge.hallyn@ubuntu.com>
Date: Mon, 9 Jun 2014 22:37:16 +0000 (-0500)
Subject: man: newuid and newgid: point out that root must be allocated subuids
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fheads%2Fnewuidmap.root.man;p=thirdparty%2Fshadow.git

man: newuid and newgid: point out that root must be allocated subuids

Users may otherwise be confused and think that because the kernel
does not restrict uid mappings to the root user (within his
current uid mappings), newuidmap will ignore /etc/subuid for the
root user.  It will not.

Reported-by: Philippe Grégoire <gregoirep@hotmail.com>
Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>
---

diff --git a/man/newgidmap.1.xml b/man/newgidmap.1.xml
index ad7a186ed..3c1955ac0 100644
--- a/man/newgidmap.1.xml
+++ b/man/newgidmap.1.xml
@@ -85,6 +85,8 @@
     <para>
       The <command>newgidmap</command> sets <filename>/proc/[pid]/gid_map</filename> based on it's
       command line arguments and the gids allowed in <filename>/etc/subgid</filename>.
+      Note that the root user is not exempted from the requirement for a valid
+      <filename>/etc/subgid</filename> entry.
     </para>
 
     <para>
diff --git a/man/newuidmap.1.xml b/man/newuidmap.1.xml
index 04bb14fc6..e07414f12 100644
--- a/man/newuidmap.1.xml
+++ b/man/newuidmap.1.xml
@@ -82,6 +82,8 @@
     <para>
       The <command>newuidmap</command> sets <filename>/proc/[pid]/uid_map</filename> based on it's
       command line arguments and the uids allowed in <filename>/etc/subuid</filename>.
+      Note that the root user is not exempted from the requirement for a valid
+      <filename>/etc/subuid</filename> entry.
     </para>
 
     <para>