Manpages improvement for subordinate IDs.

	* man/newusers.8.xml: Include documentation of SUB_GID_MIN,
	SUB_GID_MAX, SUB_GID_COUNT, SUB_UID_MIN, SUB_UID_MAX,
	SUB_UID_COUNT.
	* man/useradd.8.xml: Likewise.
	* man/usermod.8.xml: Likewise.
	* man/newusers.8.xml: Document usage of /etc/subgid /etc/subuid.
	* man/useradd.8.xml: Likewise.
	* man/userdel.8.xml: Likewise.
	* man/usermod.8.xml: Likewise.
	* man/newusers.8.xml: Add references to subgid(5) and subuid(5).
	* man/useradd.8.xml: Likewise.
	* man/userdel.8.xml: Likewise.
	* man/subgid.5.xml: Sort references alphabetically.
	* man/subuid.5.xml: Likewise.
	* man/subgid.5.xml: Add references to newusers(8), useradd(8),
	userdel(8), usermod(8), user_namespaces(7).
	* man/subuid.5.xml: Likewise.

diff --git a/ChangeLog b/ChangeLog
index c5634515394593700d739deb8559d09715ae92ab..aa482afdd8d4c861d274b28fc4fe6f0d98b30d2f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,23 @@
+2013-08-11  Nicolas François  <nicolas.francois@centraliens.net>
+
+       * man/newusers.8.xml: Include documentation of SUB_GID_MIN,
+       SUB_GID_MAX, SUB_GID_COUNT, SUB_UID_MIN, SUB_UID_MAX,
+       SUB_UID_COUNT.
+       * man/useradd.8.xml: Likewise.
+       * man/usermod.8.xml: Likewise.
+       * man/newusers.8.xml: Document usage of /etc/subgid /etc/subuid.
+       * man/useradd.8.xml: Likewise.
+       * man/userdel.8.xml: Likewise.
+       * man/usermod.8.xml: Likewise.
+       * man/newusers.8.xml: Add references to subgid(5) and subuid(5).
+       * man/useradd.8.xml: Likewise.
+       * man/userdel.8.xml: Likewise.
+       * man/subgid.5.xml: Sort references alphabetically.
+       * man/subuid.5.xml: Likewise.
+       * man/subgid.5.xml: Add references to newusers(8), useradd(8),
+       userdel(8), usermod(8), user_namespaces(7).
+       * man/subuid.5.xml: Likewise.
+
 2013-08-11  Nicolas François  <nicolas.francois@centraliens.net>
 
        * man/newgidmap.1.xml: Sort references alphabetically.

diff --git a/man/newusers.8.xml b/man/newusers.8.xml
index a2773c083c2a89b18d459862dcfbf037586ef6c0..db501eaf21982fcef94be6c693f28942eb3145d9 100644 (file)
--- a/man/newusers.8.xml
+++ b/man/newusers.8.xml
@@ -38,6 +38,8 @@
 <!ENTITY PASS_MIN_DAYS         SYSTEM "login.defs.d/PASS_MIN_DAYS.xml">
 <!ENTITY PASS_WARN_AGE         SYSTEM "login.defs.d/PASS_WARN_AGE.xml">
 <!ENTITY SHA_CRYPT_MIN_ROUNDS  SYSTEM "login.defs.d/SHA_CRYPT_MIN_ROUNDS.xml">
+<!ENTITY SUB_GID_COUNT         SYSTEM "login.defs.d/SUB_GID_COUNT.xml">
+<!ENTITY SUB_UID_COUNT         SYSTEM "login.defs.d/SUB_UID_COUNT.xml">
 <!ENTITY SYS_GID_MAX           SYSTEM "login.defs.d/SYS_GID_MAX.xml">
 <!ENTITY SYS_UID_MAX           SYSTEM "login.defs.d/SYS_UID_MAX.xml">
 <!ENTITY UID_MAX               SYSTEM "login.defs.d/UID_MAX.xml">
@@ -383,6 +385,8 @@
       &SHA_CRYPT_MIN_ROUNDS; <!-- documents also SHA_CRYPT_MAX_ROUNDS-->
     </variablelist>
     <variablelist>
+      &SUB_GID_COUNT; <!-- documents also SUB_GID_MAX and SUB_GID_MIN -->
+      &SUB_UID_COUNT; <!-- documents also SUB_UID_MAX and SUB_UID_MIN -->
       &SYS_GID_MAX; <!-- documents also SYS_GID_MIN -->
       &SYS_UID_MAX; <!-- documents also SYS_UID_MIN -->
       &UID_MAX; <!-- documents also UID_MIN -->
@@ -429,6 +433,18 @@
          <para>PAM configuration for <command>newusers</command>.</para>
        </listitem>
       </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subgid</filename></term>
+       <listitem>
+         <para>Per user subordinate group IDs.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subuid</filename></term>
+       <listitem>
+         <para>Per user subordinate user IDs.</para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>
 
@@ -441,6 +457,14 @@
       <citerefentry>
        <refentrytitle>passwd</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
+      <phrase condition="subids">
+       <citerefentry>
+         <refentrytitle>subgid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+       <citerefentry>
+         <refentrytitle>subuid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+      </phrase>
       <citerefentry>
        <refentrytitle>useradd</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>.

diff --git a/man/subgid.5.xml b/man/subgid.5.xml
index 5ef238f89be575145f63093e06af47940804a1a5..f7b4b50b7f91d48404ebbe621e70eb3424292728 100644 (file)
--- a/man/subgid.5.xml
+++ b/man/subgid.5.xml
@@ -101,20 +101,32 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-       <refentrytitle>subuid</refentrytitle><manvolnum>5</manvolnum>
+       <refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
       </citerefentry>,
       <citerefentry>
-       <refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
+       <refentrytitle>newgidmap</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
       <citerefentry>
        <refentrytitle>newuidmap</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
       <citerefentry>
-       <refentrytitle>newgidmap</refentrytitle><manvolnum>1</manvolnum>
+       <refentrytitle>newusers</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>subuid</refentrytitle><manvolnum>5</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>useradd</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>userdel</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
        <refentrytitle>usermod</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <citerefentry>
+       <refentrytitle>user_namespaces</refentrytitle><manvolnum>7</manvolnum>
+      </citerefentry>.
     </para>
   </refsect1>
 </refentry>

diff --git a/man/subuid.5.xml b/man/subuid.5.xml
index 70fbc752b7a15ddf36a2b79f1c1dadef07a46d10..a833f57f279467186b9ebdb360a4546360d0e43c 100644 (file)
--- a/man/subuid.5.xml
+++ b/man/subuid.5.xml
@@ -101,20 +101,32 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-       <refentrytitle>subgid</refentrytitle><manvolnum>5</manvolnum>
+       <refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
       </citerefentry>,
       <citerefentry>
-       <refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
+       <refentrytitle>newgidmap</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
       <citerefentry>
        <refentrytitle>newuidmap</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry>,
       <citerefentry>
-       <refentrytitle>newgidmap</refentrytitle><manvolnum>1</manvolnum>
+       <refentrytitle>newusers</refentrytitle><manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>subgid</refentrytitle><manvolnum>5</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>useradd</refentrytitle><manvolnum>8</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+       <refentrytitle>userdel</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
       <citerefentry>
        <refentrytitle>usermod</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <citerefentry>
+       <refentrytitle>user_namespaces</refentrytitle><manvolnum>7</manvolnum>
+      </citerefentry>.
     </para>
   </refsect1>
 </refentry>

diff --git a/man/useradd.8.xml b/man/useradd.8.xml
index f59f96ae9156563fe0049a4a49e741ce7458eaa5..34b2c1589eef4126b0cf35217530c354573a4f40 100644 (file)
--- a/man/useradd.8.xml
+++ b/man/useradd.8.xml
@@ -37,6 +37,8 @@
 <!ENTITY PASS_MAX_DAYS         SYSTEM "login.defs.d/PASS_MAX_DAYS.xml">
 <!ENTITY PASS_MIN_DAYS         SYSTEM "login.defs.d/PASS_MIN_DAYS.xml">
 <!ENTITY PASS_WARN_AGE         SYSTEM "login.defs.d/PASS_WARN_AGE.xml">
+<!ENTITY SUB_GID_COUNT         SYSTEM "login.defs.d/SUB_GID_COUNT.xml">
+<!ENTITY SUB_UID_COUNT         SYSTEM "login.defs.d/SUB_UID_COUNT.xml">
 <!ENTITY SYS_GID_MAX           SYSTEM "login.defs.d/SYS_GID_MAX.xml">
 <!ENTITY SYS_UID_MAX           SYSTEM "login.defs.d/SYS_UID_MAX.xml">
 <!ENTITY UID_MAX               SYSTEM "login.defs.d/UID_MAX.xml">
@@ -679,6 +681,8 @@
       &PASS_MAX_DAYS;
       &PASS_MIN_DAYS;
       &PASS_WARN_AGE;
+      &SUB_GID_COUNT; <!-- documents also SUB_GID_MAX and SUB_GID_MIN -->
+      &SUB_UID_COUNT; <!-- documents also SUB_UID_MAX and SUB_UID_MIN -->
       &SYS_GID_MAX; <!-- documents also SYS_GID_MIN -->
       &SYS_UID_MAX; <!-- documents also SYS_UID_MIN -->
       &TCB_AUTH_GROUP;
@@ -729,6 +733,18 @@
          <para>Directory containing default files.</para>
        </listitem>
       </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subgid</filename></term>
+       <listitem>
+         <para>Per user subordinate group IDs.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subuid</filename></term>
+       <listitem>
+         <para>Per user subordinate user IDs.</para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><filename>/etc/login.defs</filename></term>
        <listitem>
@@ -837,6 +853,14 @@
       <citerefentry>
        <refentrytitle>newusers</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <phrase condition="subids">
+       <citerefentry>
+         <refentrytitle>subgid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+       <citerefentry>
+         <refentrytitle>subuid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+      </phrase>
       <citerefentry>
        <refentrytitle>userdel</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,

diff --git a/man/userdel.8.xml b/man/userdel.8.xml
index 4890dd9f2146a997f251fa98465aec11324c1bef..589701ac19d332710fa51419d9a219b073a36279 100644 (file)
--- a/man/userdel.8.xml
+++ b/man/userdel.8.xml
@@ -212,6 +212,18 @@
          <para>Secure user account information.</para>
        </listitem>
       </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subgid</filename></term>
+       <listitem>
+         <para>Per user subordinate group IDs.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subuid</filename></term>
+       <listitem>
+         <para>Per user subordinate user IDs.</para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>
 
@@ -319,6 +331,14 @@
       <citerefentry>
        <refentrytitle>groupmod</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <phrase condition="subids">
+       <citerefentry>
+         <refentrytitle>subgid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+       <citerefentry>
+         <refentrytitle>subuid</refentrytitle><manvolnum>5</manvolnum>
+       </citerefentry>,
+      </phrase>
       <citerefentry>
        <refentrytitle>useradd</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,

diff --git a/man/usermod.8.xml b/man/usermod.8.xml
index 2bfe4dda131c4ee36ded5aa6449102615ff42804..c3b78619aa27efbc8bb19bbffe28445fce944f35 100644 (file)
--- a/man/usermod.8.xml
+++ b/man/usermod.8.xml
@@ -32,6 +32,8 @@
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 <!ENTITY MAIL_DIR              SYSTEM "login.defs.d/MAIL_DIR.xml">
 <!ENTITY MAX_MEMBERS_PER_GROUP SYSTEM "login.defs.d/MAX_MEMBERS_PER_GROUP.xml">
+<!ENTITY SUB_GID_COUNT         SYSTEM "login.defs.d/SUB_GID_COUNT.xml">
+<!ENTITY SUB_UID_COUNT         SYSTEM "login.defs.d/SUB_UID_COUNT.xml">
 <!ENTITY TCB_SYMLINKS          SYSTEM "login.defs.d/TCB_SYMLINKS.xml">
 <!ENTITY USE_TCB               SYSTEM "login.defs.d/USE_TCB.xml">
 <!-- SHADOW-CONFIG-HERE -->
@@ -517,6 +519,8 @@
     <variablelist>
       &MAIL_DIR; <!-- documents also MAIL_FILE -->
       &MAX_MEMBERS_PER_GROUP;
+      &SUB_GID_COUNT; <!-- documents also SUB_GID_MAX and SUB_GID_MIN -->
+      &SUB_UID_COUNT; <!-- documents also SUB_UID_MAX and SUB_UID_MIN -->
       &TCB_SYMLINKS;
       &USE_TCB;
     </variablelist>
@@ -555,6 +559,18 @@
          <para>Secure user account information.</para>
        </listitem>
       </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subgid</filename></term>
+       <listitem>
+         <para>Per user subordinate group IDs.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry condition="subids">
+       <term><filename>/etc/subuid</filename></term>
+       <listitem>
+         <para>Per user subordinate user IDs.</para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>