[Pkg-shadow-commits] r1987 - in upstream/trunk: . man

[nekral-guest at alioth.debian.org]

Author: nekral-guest
Date: 2008-05-19 20:53:12 +0000 (Mon, 19 May 2008)
New Revision: 1987

Modified:
   upstream/trunk/ChangeLog
   upstream/trunk/NEWS
   upstream/trunk/man/groupadd.8.xml
   upstream/trunk/man/newusers.8.xml
   upstream/trunk/man/useradd.8.xml
Log:
	* 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.


Modified: upstream/trunk/ChangeLog
===================================================================
--- upstream/trunk/ChangeLog	2008-05-19 20:31:48 UTC (rev 1986)
+++ upstream/trunk/ChangeLog	2008-05-19 20:53:12 UTC (rev 1987)
@@ -5,6 +5,10 @@
 2008-05-19  Nicolas François  <nicolas.francois at 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 at centraliens.net>
 

Modified: upstream/trunk/NEWS
===================================================================
--- upstream/trunk/NEWS	2008-05-19 20:31:48 UTC (rev 1986)
+++ upstream/trunk/NEWS	2008-05-19 20:53:12 UTC (rev 1987)
@@ -23,7 +23,10 @@
   * 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
 

Modified: upstream/trunk/man/groupadd.8.xml
===================================================================
--- upstream/trunk/man/groupadd.8.xml	2008-05-19 20:31:48 UTC (rev 1986)
+++ upstream/trunk/man/groupadd.8.xml	2008-05-19 20:53:12 UTC (rev 1987)
@@ -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>
 

Modified: upstream/trunk/man/newusers.8.xml
===================================================================
--- upstream/trunk/man/newusers.8.xml	2008-05-19 20:31:48 UTC (rev 1986)
+++ upstream/trunk/man/newusers.8.xml	2008-05-19 20:53:12 UTC (rev 1987)
@@ -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>

Modified: upstream/trunk/man/useradd.8.xml
===================================================================
--- upstream/trunk/man/useradd.8.xml	2008-05-19 20:31:48 UTC (rev 1986)
+++ upstream/trunk/man/useradd.8.xml	2008-05-19 20:53:12 UTC (rev 1987)
@@ -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>