* man/useradd.8.xml, man/groupadd.8.xml, man/usermod.8.xml,

	man/groupmod.8.xml: Avoid hardcoded values, and reference instead
	the configuration options (e.g. UID_MIN)
	* man/groupmod.8.xml, man/usermod.8.xml: Add missing reference to
	login.defs
	* man/login.defs.d/UID_MAX.xml, man/login.defs.d/SYS_UID_MAX.xml,
	man/login.defs.d/GID_MAX.xml, man/login.defs.d/SYS_GID_MAX.xml:
	Document the default values.

diff --git a/ChangeLog b/ChangeLog
index 168308af03218a6723fe590272f73512505c4976..8ea8d6eea8d51ce4e1fbb95679ec94850bfe9735 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,4 +1,15 @@
-2011-11-16  Nicolas François  <nicolas.francois@centraliens.net>
+2011-11-19  Nicolas François  <nicolas.francois@centraliens.net>
+
+       * man/useradd.8.xml, man/groupadd.8.xml, man/usermod.8.xml,
+       man/groupmod.8.xml: Avoid hardcoded values, and reference instead
+       the configuration options (e.g. UID_MIN)
+       * man/groupmod.8.xml, man/usermod.8.xml: Add missing reference to
+       login.defs
+       * man/login.defs.d/UID_MAX.xml, man/login.defs.d/SYS_UID_MAX.xml,
+       man/login.defs.d/GID_MAX.xml, man/login.defs.d/SYS_GID_MAX.xml:
+       Document the default values.
+
+2011-11-19  Nicolas François  <nicolas.francois@centraliens.net>
 
        * src/gpasswd.c: Change of group password enforces gshadow
        password. Set /etc/group password to "x".

diff --git a/man/groupadd.8.xml b/man/groupadd.8.xml
index 2f07e6e1d599306038426e6f11e1516e8ac786df..caded6bea63105302997f9e657c7c95cfa879095 100644 (file)
--- a/man/groupadd.8.xml
+++ b/man/groupadd.8.xml
@@ -99,9 +99,12 @@
          <para>The numerical value of the group's ID. This value must be
            unique, unless the <option>-o</option> option is used. The value
            must be non-negative. The default is to use the smallest ID
-           value greater than 999 and greater than every other group.
-           Values between 0 and 999 are typically reserved for system
-           accounts.
+           value greater than or equal to <option>GID_MIN</option> and
+           greater than every other group.
+         </para>
+         <para>
+           See also the <option>-r</option> option and the
+           <option>GID_MAX</option> description.
          </para>
        </listitem>
       </varlistentry>

diff --git a/man/groupmod.8.xml b/man/groupmod.8.xml
index 640250e2ca81d4259556b7d9d71fa53aba47aef1..f50cdf66ec99d376af0f2398194eaaf87606ce73 100644 (file)
--- a/man/groupmod.8.xml
+++ b/man/groupmod.8.xml
@@ -86,8 +86,7 @@
            The value of
            <replaceable>GID</replaceable> must be a non-negative decimal
            integer. This value must be unique, unless the
-           <option>-o</option> option is used. Values between 0 and 999 are
-           typically reserved for system groups.
+           <option>-o</option> option is used.
          </para>
          <para>
            Users who use the group as primary group will be updated to
@@ -99,6 +98,12 @@
            <replaceable>GROUP</replaceable>, must have their group ID
            changed manually.
          </para>
+         <para>
+           No checks will be performed with regard to the
+           <option>GID_MIN</option>, <option>GID_MAX</option>,
+           <option>SYS_GID_MIN</option>, or <option>SYS_GID_MAX</option>
+           from <filename>/etc/login.defs</filename>.
+         </para>
        </listitem>
       </varlistentry>
       <varlistentry>
@@ -195,6 +200,12 @@
          <para>Secure group account information.</para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><filename>/etc/login.defs</filename></term>
+       <listitem>
+         <para>Shadow password suite configuration.</para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><filename>/etc/passwd</filename></term>
        <listitem>
@@ -276,6 +287,9 @@
       <citerefentry>
        <refentrytitle>groupdel</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,
+      <citerefentry>
+       <refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum>
+      </citerefentry>,
       <citerefentry>
        <refentrytitle>useradd</refentrytitle><manvolnum>8</manvolnum>
       </citerefentry>,

diff --git a/man/login.defs.d/GID_MAX.xml b/man/login.defs.d/GID_MAX.xml
index fdf18e9b7e912f53fca9549ec3257a65995b6157..639eafb0d431d7ce0a59d333433b59c959a75570 100644 (file)
--- a/man/login.defs.d/GID_MAX.xml
+++ b/man/login.defs.d/GID_MAX.xml
@@ -37,5 +37,9 @@
       <command>useradd</command>, <command>groupadd</command>, or
       <command>newusers</command>.
     </para>
+    <para>
+      The default value for <option>GID_MIN</option> (resp.
+      <option>GID_MAX</option>) is 1000 (resp. 60000).
+    </para>
   </listitem>
 </varlistentry>

diff --git a/man/login.defs.d/SYS_GID_MAX.xml b/man/login.defs.d/SYS_GID_MAX.xml
index 547139a6e39a8025d89590912748f079393cfe06..4a9ed28b902f622b40274042964dbf8b86f06bf2 100644 (file)
--- a/man/login.defs.d/SYS_GID_MAX.xml
+++ b/man/login.defs.d/SYS_GID_MAX.xml
@@ -35,5 +35,9 @@
       <command>useradd</command>, <command>groupadd</command>, or
       <command>newusers</command>.
     </para>
+    <para>
+      The default value for <option>SYS_GID_MIN</option> (resp.
+      <option>SYS_GID_MAX</option>) is 101 (resp. <option>GID_MIN</option>-1).
+    </para>
   </listitem>
 </varlistentry>

diff --git a/man/login.defs.d/SYS_UID_MAX.xml b/man/login.defs.d/SYS_UID_MAX.xml
index 2d82563acd4afeba983cb8deb6f797c093a7ab7d..3ca6cee2f9baddb0cf65eed31c4965ba191eeb41 100644 (file)
--- a/man/login.defs.d/SYS_UID_MAX.xml
+++ b/man/login.defs.d/SYS_UID_MAX.xml
@@ -34,5 +34,9 @@
       Range of user IDs used for the creation of system users by
       <command>useradd</command> or <command>newusers</command>.
     </para>
+    <para>
+      The default value for <option>SYS_UID_MIN</option> (resp.
+      <option>SYS_UID_MAX</option>) is 101 (resp. <option>UID_MIN</option>-1).
+    </para>
   </listitem>
 </varlistentry>

diff --git a/man/login.defs.d/UID_MAX.xml b/man/login.defs.d/UID_MAX.xml
index c3054ea1102ad461291232ed913a2739074c4a79..77cf41f9fe7f67da740f13f89ba5d8df82824fae 100644 (file)
--- a/man/login.defs.d/UID_MAX.xml
+++ b/man/login.defs.d/UID_MAX.xml
@@ -36,5 +36,9 @@
       Range of user IDs used for the creation of regular users by
       <command>useradd</command> or <command>newusers</command>.
     </para>
+    <para>
+      The default value for <option>UID_MIN</option> (resp.
+      <option>UID_MAX</option>) is 1000 (resp. 60000).
+    </para>
   </listitem>
 </varlistentry>

diff --git a/man/useradd.8.xml b/man/useradd.8.xml
index d1d1f1c18973f3852d3df099d83fae52005c4da2..ff165b122a704dbd46423246916e5d967472a96b 100644 (file)
--- a/man/useradd.8.xml
+++ b/man/useradd.8.xml
@@ -472,8 +472,12 @@
            The numerical value of the user's ID. This value must be unique,
            unless the <option>-o</option> option is used. The value must be
            non-negative. The default is to use the smallest ID value
-           greater than 999 and greater than every other user. Values
-           between 0 and 999 are typically reserved for system accounts.
+           greater than or equal to <option>UID_MIN</option> and greater
+           than every other user.
+         </para>
+         <para>
+           See also the <option>-r</option> option and the
+           <option>UID_MAX</option> description.
          </para>
        </listitem>
       </varlistentry>

diff --git a/man/usermod.8.xml b/man/usermod.8.xml
index 3a85b86d0375265125c13e8ef09ea9cf77da1aa6..f56d17135045ae627f571531e6528ab15224854b 100644 (file)
--- a/man/usermod.8.xml
+++ b/man/usermod.8.xml
@@ -331,8 +331,7 @@
          <para>
            This value must be unique,
            unless the <option>-o</option> option is used. The value must be
-           non-negative. Values between 0 and 999 are typically reserved
-           for system accounts.
+           non-negative.
          </para>
          <para>
            The user's mailbox, and any files which the user owns and which are
@@ -343,6 +342,12 @@
            The ownership of files outside of the user's home directory
            must be fixed manually.
          </para>
+         <para>
+           No checks will be performed with regard to the
+           <option>UID_MIN</option>, <option>UID_MAX</option>,
+           <option>SYS_UID_MIN</option>, or <option>SYS_UID_MAX</option>
+           from <filename>/etc/login.defs</filename>.
+         </para>
        </listitem>
       </varlistentry>
       <varlistentry>
@@ -430,6 +435,12 @@
          <para>Secure group account information.</para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><filename>/etc/login.defs</filename></term>
+       <listitem>
+         <para>Shadow password suite configuration.</para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><filename>/etc/passwd</filename></term>
        <listitem>