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 ad7a186ed5597c958d4a0bced1de8e1691d47d58..3c1955ac058457d9ee8a3f415139d37577725524 100644 (file)
--- 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 04bb14fc68d8f16c2bc9c3989ec3e63025cd10d9..e07414f12454fd4eef61df33d6f6ff0d9393bd7d 100644 (file)
--- 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>