* NEWS, man/groupadd.8.xml: Document the -r, --system option.

	* NEWS, man/newusers.8.xml: Document the -r, --system option.
	* NEWS, man/newusers.8.xml: Document the -c, --crypt-method and
	-s, --sha-rounds options.

diff --git a/ChangeLog b/ChangeLog
index ecfa1510abdc21bb67d4482638ad822dea759ea9..4b01f1c2a336c4249f83f32ac3a7a165aa52f881 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,6 +5,10 @@
 2008-05-19  Nicolas François  <nicolas.francois@centraliens.net>
 
        * NEWS, man/useradd.8.xml: Document the -r, --system option.
+       * NEWS, man/groupadd.8.xml: Document the -r, --system option.
+       * NEWS, man/newusers.8.xml: Document the -r, --system option.
+       * NEWS, man/newusers.8.xml: Document the -c, --crypt-method and
+       -s, --sha-rounds options.
 
 2008-05-18  Nicolas François  <nicolas.francois@centraliens.net>
 

diff --git a/NEWS b/NEWS
index f0e7853556aca9e2919f7fddfcab80c28a43c477..db1ee125719648d69a193742ff12c0362d517dd0 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -23,7 +23,10 @@ shadow-4.1.1 -> shadow-4.1.2                                         UNRELEASED
   * Resume properly after ^Z.
 
 *** documentation:
-- Document the -r, --system option in the useradd manpage.
+- Document the -r, --system option in the useradd, groupadd, and newusers
+  manpages.
+- Document the -c, --crypt-method and -s, --sha-rounds options in the
+  newusers manpage.
 
 shadow-4.1.0 -> shadow-4.1.1                                           02-04-2008
 

diff --git a/man/groupadd.8.xml b/man/groupadd.8.xml
index cc2958387f2c8c0ead45a925dd71e43e1a773288..92b335cea3134dd66ced7053e0d16b0346a155f2 100644 (file)
--- a/man/groupadd.8.xml
+++ b/man/groupadd.8.xml
@@ -126,6 +126,22 @@
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term>
+         <option>-r</option>, <option>--system</option>
+       </term>
+       <listitem>
+         <para>
+           Create a system group.
+         </para>
+         <para>
+           The numeric identifiers of new system groups are choosen in
+           the <option>SYS_GID_MIN</option>-<option>SYS_GID_MAX</option>
+           range, defined in <filename>login.defs</filename>, instead of
+           <option>GID_MIN</option>-<option>GID_MAX</option>.
+         </para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>
 

diff --git a/man/newusers.8.xml b/man/newusers.8.xml
index afc608ead2e2a3f2057e7e35cd277f2324a48e5d..5b7486c8b5234960afa61c6752b15e0b8acd3f8d 100644 (file)
--- a/man/newusers.8.xml
+++ b/man/newusers.8.xml
@@ -94,6 +94,68 @@
     </para>
   </refsect1>
 
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <para>The options which apply to the <command>newusers</command> command are:
+    </para>
+    <variablelist remap='IP'>
+      <varlistentry>
+       <term><option>-c</option>, <option>--crypt-method</option></term>
+       <listitem>
+         <para>Use the specified method to encrypt the passwords.</para>
+         <para>
+           The available methods are DES, MD5, NONE, and SHA256 or SHA512
+           if your libc support these methods.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>
+         <option>-r</option>, <option>--system</option>
+       </term>
+       <listitem>
+         <para>
+           Create a system account.
+         </para>
+         <para>
+           System users will be created with no aging information in
+           <filename>/etc/shadow</filename>, and their numeric
+           identifiers are choosen in the
+           <option>SYS_UID_MIN</option>-<option>SYS_UID_MAX</option>
+           range, defined in <filename>login.defs</filename>, instead of
+           <option>UID_MIN</option>-<option>UID_MAX</option> (and their
+           <option>GID</option> counterparts for the creation of groups).
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry condition="sha_crypt">
+       <term><option>-s</option>, <option>--sha-rounds</option></term>
+       <listitem>
+         <para>
+           Use the specified number of rounds to encrypt the passwords.
+         </para>
+         <para>
+           The value 0 means that the system will choose the default
+           number of rounds for the crypt method (5000).
+         </para>
+         <para>
+           A minimal value of 1000 and a maximal value of 999,999,999
+           will be enforced.
+         </para>
+         <para>
+           You can only use this option with the SHA256 or SHA512
+           crypt method.
+         </para>
+         <para>
+           By default, the number of rounds is defined by the
+           SHA_CRYPT_MIN_ROUNDS and SHA_CRYPT_MAX_ROUNDS variables in
+           <filename>/etc/login.defs</filename>.
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
   <refsect1 id='caveats'>
     <title>CAVEATS</title>
     <para>

diff --git a/man/useradd.8.xml b/man/useradd.8.xml
index f82afe9fb41583501172cc9505f480f9a56f4de0..07c6600848cfdc39722d3c57407130bca11b0050 100644 (file)
--- a/man/useradd.8.xml
+++ b/man/useradd.8.xml
@@ -291,9 +291,10 @@
          </para>
          <para>
            System users will be created with no aging information in
-           <filename>/etc/shadow</filename>, and will use the
+           <filename>/etc/shadow</filename>, and their numeric
+           identifiers are choosen in the
            <option>SYS_UID_MIN</option>-<option>SYS_UID_MAX</option>
-           range for their user's ID instead of
+           range, defined in <filename>login.defs</filename>, instead of
            <option>UID_MIN</option>-<option>UID_MAX</option> (and their
            <option>GID</option> counterparts for the creation of groups).
          </para>