[Pkg-cracklib-commits] r22 - cracklib2/trunk/debian

jandd-guest at alioth.debian.org jandd-guest at alioth.debian.org
Mon Jun 30 12:41:50 UTC 2008


Author: jandd-guest
Date: 2008-06-30 12:41:50 +0000 (Mon, 30 Jun 2008)
New Revision: 22

Added:
   cracklib2/trunk/debian/cracklib-runtime.dirs
   cracklib2/trunk/debian/cracklib-runtime.xml
Removed:
   cracklib2/trunk/debian/cracklib-runtime.html
Modified:
   cracklib2/trunk/debian/changelog
   cracklib2/trunk/debian/cracklib-runtime.docs
   cracklib2/trunk/debian/libcrack2.xml
   cracklib2/trunk/debian/rules
Log:
* DocBook documenation for cracklib-runtime
* add /var/cache/cracklib to cracklib-runtime.dirs
* improve debian/changelog entry's readability
* specify default dictionary in debian/rules


Modified: cracklib2/trunk/debian/changelog
===================================================================
--- cracklib2/trunk/debian/changelog	2008-06-30 10:20:28 UTC (rev 21)
+++ cracklib2/trunk/debian/changelog	2008-06-30 12:41:50 UTC (rev 22)
@@ -5,36 +5,39 @@
     derivative license to the GPL-2 and mention new upstream
   * removed Debian patches that are no longer required because of upstream
     improvements
-  * switch from cdbs to debhelper
-  * update to Standards-Version 3.8.0
-  * add Homepage field to debian/control
-  * provide a new binary package python-cracklib using python-central
-  * add Build-Depends for python-all, python-all-dev, python-central, and
-    chrpath
-  * add XS-Python and XB-Python fields to debian/control
+  * debian/rules
+    + switch from cdbs to debhelper
+    + change default dictionary path to /var/lib/cracklib/pw_dict
+    + fix rpath issues in built utils using chrpath
+  * debian/control
+    + update to Standards-Version 3.8.0
+    + add Homepage field
+    + provide a new binary package python-cracklib using python-central
+    + add Build-Depends for python-all, python-all-dev, python-central,
+      and chrpath
+    + add XS-Python and XB-Python fields to debian/control
+    + rename binary package cracklib2 to libcrack2 and cracklib2-dev to
+      libcrack2-dev, add the corresponding Provides, Conflicts and
+      Replaces
+    + make libcrack2-dev depend on libcrack2 with the same
+      binary:Version
+    + change Maintainer to Jan Dittberner
+    + set Uploaders field to previous Maintainer Martin Pitt
+    + add Vcs-Svn and Vcs-Svn-Browser to debian/control
   * fix debian/cracklib-runtime.preinst to use dpkg-query instead of
     directly accessing /var/lib/dpkg/status
   * add debian/pycompat for dh_python
   * update script update-cracklib to use cracklib-format and
     cracklib-packer
-  * change default dictionary path to /var/lib/cracklib/pw_dict
-  * fix rpath issues in built utils using chrpath
-  * rename binary package cracklib2 to libcrack2 and cracklib2-dev to
-    libcrack2-dev, add the corresponding Provides and Conflicts to
-    debian/control
   * man pages for the new commands, updated existing man pages (Closes:
     #429993)
-  * add Replaces for libcrack2-dev to debian/control
-  * make libcrack2-dev depend on libcrack2 with the same binary:Version
-  * let libcrack2 provide cracklib2
   * add debian/watch file for uscan
   * let debian/examples/cracklib_example.c use NULL to specify the default
     dictionary path
   * convert HTML documentation to DocBook XML and update it
+  * fix man2html URLs in documentation to reflect man2html's current URL
+    syntax
   * add README, README-DAWG, and README-WORDS from upstream package
-  * change Maintainer in debian/control to Jan Dittberner
-  * add previous Maintainer Martin Pitt to Uploaders in debian/control
-  * add Vcs-Svn and Vcs-Svn-Browser to debian/control
 
  -- Jan Dittberner <jan at dittberner.info>  Mon, 23 Jun 2008 00:28:13 +0200
 

Added: cracklib2/trunk/debian/cracklib-runtime.dirs
===================================================================
--- cracklib2/trunk/debian/cracklib-runtime.dirs	                        (rev 0)
+++ cracklib2/trunk/debian/cracklib-runtime.dirs	2008-06-30 12:41:50 UTC (rev 22)
@@ -0,0 +1 @@
+/var/cache/cracklib
\ No newline at end of file

Modified: cracklib2/trunk/debian/cracklib-runtime.docs
===================================================================
--- cracklib2/trunk/debian/cracklib-runtime.docs	2008-06-30 10:20:28 UTC (rev 21)
+++ cracklib2/trunk/debian/cracklib-runtime.docs	2008-06-30 12:41:50 UTC (rev 22)
@@ -1 +1 @@
-debian/cracklib-runtime.html
+debian/doc/cracklib-runtime.html

Deleted: cracklib2/trunk/debian/cracklib-runtime.html
===================================================================
--- cracklib2/trunk/debian/cracklib-runtime.html	2008-06-30 10:20:28 UTC (rev 21)
+++ cracklib2/trunk/debian/cracklib-runtime.html	2008-06-30 12:41:50 UTC (rev 22)
@@ -1,334 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-
-<html>
-  <head>
-    <title>cracklib2 - utilities</title>
-
-    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
-    <meta http-equiv="keywords" content="crack, cracklib, password, security" />
-  </head>
-
-
-  <body>
-    <h1>cracklib2 - utilities</h1>
-
-    <p>
-      <code>cracklib2</code> is a library containing a C function which may be
-      used in a <a
-      href="/cgi-bin/man2html/usr/share/man/man1/passwd.1.gz"><code>passwd</code></a>
-      like program.  The idea is simple: try to prevent users from choosing
-      passwords that could be guessed by <a
-      href="http://www.crypticide.org/users/alecm"><code>crack</code></a> by filtering them out, at
-      source. <code>cracklib2</code> is <em>not</em> a replacement <a
-      href="/cgi-bin/man2html/usr/share/man/man1/passwd.1.gz"><code>passwd</code></a>
-      program.  <code>cracklib2</code> is a <em>library</em>.
-    </p>
-
-    <p>
-     <code>cracklib-runtime</code> contains run-time support programs which use
-     the shared library in <a
-     href="../cracklib2/cracklib2.html"><code>cracklib2</code></a> including
-     programs to build the password dictionary databases used by the functions
-     in the shared library.
-    </p>
-
-
-    <h2>Index</h2>
-
-    <ol>
-      <li>
-        <a href="../cracklib2/cracklib2.html">General documentation on
-        <code>cracklib2</code>.</a>
-      </li>
-
-      <li>
-        <a href="#cracklib.utilities">Debian <code>cracklib2</code>
-        utilities.</a>
-
-        <ol>
-          <li>
-            <a href="#cracklib.utilities.dictionary">Debian
-            <code>cracklib2</code> dictionary utilities.</a>
-
-            <ol>
-              <li>
-                <a href="#cracklib.utilities.dictionary.crack_mkdict"><code>crack_mkdict</code></a>
-              </li>
-
-              <li>
-                <a href="#cracklib.utilities.dictionary.crack_packer"><code>crack_packer</code></a>
-              </li>
-
-              <li>
-                <a href="#cracklib.utilities.dictionary.crack_unpacker"><code>crack_unpacker</code></a>
-              </li>
-            </ol>
-          </li>
-
-          <li>
-            <a href="#cracklib.utilities.test">Debian <code>cracklib2</code> test
-            utilities.</a>
-
-            <ol>
-              <li>
-                <a href="#cracklib.utilities.test.crack_testlib"><code>crack_testlib</code></a>
-              </li>
-
-              <li>
-                <a href="#cracklib.utilities.test.crack_testnum"><code>crack_testnum</code></a>
-              </li>
-
-              <li>
-                <a href="#cracklib.utilities.test.crack_teststr"><code>crack_teststr</code></a>
-              </li>
-            </ol>
-          </li>
-        </ol>
-      </li>
-
-      <li>
-        <a href="#cracklib.dictionaries">Debian dictionaries.</a>
-      </li>
-    </ol>
-
-    <hr/>
-
-
-    <h2>
-      <a id="cracklib.utilities">Debian <code>cracklib2</code> utilities</a>
-    </h2>
-
-    <h3>
-      <a id="cracklib.utilities.dictionary">Debian <code>cracklib2</code>
-      dictionary utilities.</a>
-    </h3>
-
-    <h4>
-      <a id="cracklib.utilities.dictionary.crack_mkdict"><code>crack_mkdict</code></a>
-    </h4>
-
-    <h5>Synopsis</h5>
-
-    <p><code> crack_mkdict <var>file ...</var> </code></p>
-
-    <h5>Description</h5>
-
-    <p>
-      <code>crack_mkdict</code> takes a list of ASCII files each containing a
-      list of words, one per line, It lowercases all words, removes control
-      characters, and sorts the lists.  It outputs the cleaned up list to
-      standard output.
-    </p>
-
-    <p>
-      If you supply massive amounts of text to <code>crack_mkdict</code> you
-      must have enough free space available for use by the <a
-      href="/cgi-bin/man2html/usr/share/man/man1/sort.1.gz"><code>sort</code></a>
-      command.  If you do not have 20Mb free in <code>/var/tmp</code> (or
-      whatever temporary area your <a
-      href="/cgi-bin/man2html/usr/share/man/man1/sort.1.gz"><code>sort</code></a>
-      command uses), have a look at the
-      <code>/usr/sbin/crack_mkdict</code> program which is a <a
-      href="/cgi-bin/man2html/usr/share/man/man1/sh.1.gz"><code>sh</code></a>
-      program.  You can usually tweak the <a
-      href="/cgi-bin/man2html/usr/share/man/man1/sort.1.gz"><code>sort</code></a>
-      command to use any large area of disk you desire, by use of the
-      <code>-T</code> option.  <code>crack_mkdict</code> has a hook for this.
-    </p>
-
-
-    <h4>
-      <a id="cracklib.utilities.dictionary.crack_packer"><code>crack_packer</code></a>
-    </h4>
-
-    <h5>Synopsis</h5>
-
-    <p><code>crack_packer <var>cracklib_dictpath</var></code></p>
-
-    <h5>Description</h5>
-
-    <p>
-      <code>crack_packer</code> reads from standard input a list of sorted and
-      cleaned words and creates a database in the directory and prefix given by
-      the command line argument <code><var>cracklib_dictpath</var></code>.
-      Three files are created with the suffixes of <code>.hwm, .pwd, and
-      .pwi</code>.  These three files are in the format that the <a
-      href="/cgi-bin/man2html/usr/share/man/man3/FascistCheck.3.gz"><code>FascistCheck</code></a>
-      subroutine, <a
-      href="#cracklib.utilities.dictionary.crack_unpacker"><code>crack_unpacker</code></a>,
-      <a
-      href="#cracklib.utilities.test.crack_testlib"><code>crack_testlib</code></a>,
-      <a
-      href="#cracklib.utilities.test.crack_testnum"><code>crack_testnum</code></a>,
-      and <a
-      href="#cracklib.utilities.test.crack_teststr"><code>crack_teststr</code></a>
-      utilities understand. The number of words read and written are printed on
-      <a
-      href="/cgi-bin/man2html/usr/share/man/man3/stdout.3.gz"><code>stdout</code></a>.
-    </p>
-
-
-    <h4>
-      <a
-      id="cracklib.utilities.dictionary.crack_unpacker"><code>crack_unpacker</code></a>
-    </h4>
-
-    <h5>Synopsis</h5>
-
-    <p><code>crack_unpacker <var>cracklib_dictpath</var></code></p>
-
-    <h5>Description</h5>
-
-    <p>
-      <code>crack_unpacker</code> reads from the database in the directory and
-      prefix given by the command line argument
-      <code><var>cracklib_dictpath</var></code> and outputs on standard output
-      the list of words that make up the database.
-    </p>
-
-
-    <h3>
-      <a id="cracklib.utilities.test">Debian <code>cracklib2</code> test utilities.</a>
-    </h3>
-
-    <p>
-      These are command line interactive utilities to test the <a
-      href="#cracklib.dictionaries.utilities">installed cracklib
-      dictionary</a>.  Each take one string or number per line.  Enter
-      <code>^C</code> when done.
-    </p>
-
-    <h4>
-      <a id="cracklib.utilities.test.crack_testlib"><code>crack_testlib</code></a>
-    </h4>
-
-    <h5>Synopsis</h5>
-
-    <p><code>crack_testlib</code></p>
-
-    <h5>Description</h5>
-
-    <p>
-      <code>crack_testlib</code> tests if the input string will be accepted as
-      a valid password by the <a
-      href="#cracklib.dictionaries.utilities">installed
-      <code>cracklib2</code>dictionary</a> using the <a
-      href="/cgi-bin/man2html/usr/share/man/man3/FascistCheck.3.gz"><code>FascistCheck</code></a>
-      subroutine.
-    </p>
-
-
-    <h4>
-      <a id="cracklib.utilities.test.crack_testnum"><code>crack_testnum</code></a>
-    </h4>
-
-    <h5> Synopsis </h5>
-
-    <p><code>crack_testnum</code></p>
-
-    <h5>Description</h5>
-
-    <p>
-      <code>crack_testnum</code> tests if the input integer is an index to a
-      word in the <a href="#cracklib.dictionaries.utilities">installed
-      <code>cracklib2</code> dictionary</a> and returns the word if found.
-    </p>
-
-
-    <h4>
-      <a id="cracklib.utilities.test.crack_teststr"><code>crack_teststr</code></a>
-    </h4>
-
-    <h5>Synopsis</h5>
-
-    <p><code>crack_testnum</code></p>
-
-    <h5> Description </h5>
-
-    <p>
-      <code>crack_teststr</code> tests if the input string is in the <a
-      href="#cracklib.dictionaries.utilities">installed <code>cracklib2</code>
-      dictionary</a> and returns its index number if found.
-    </p>
-
-
-    <h2>
-      <a id="cracklib.dictionaries">Debian dictionaries</a>
-    </h2>
-
-    <p>
-      <code>cracklib2</code> uses a word database that is in a binary format
-      generated by the utilities <a
-      href="#cracklib.utilities.dictionary.crack_mkdict"><code>crack_mkdict</code></a>
-      and <a
-      href="#cracklib.utilities.dictionary.crack_packer"><code>crack_packer</code></a>.
-      Three files are created with the suffixes of <code>.hwm, .pwd, and
-      .pwi</code>.  These files are <em>not</em> byte-order independent, in
-      fact they are probably architecture specific, mostly due to speed
-      constraints.
-    </p>
-
-
-    <h3>
-      <a id="cracklib.dictionaries.utilities">Compiled database location for
-      <code>cracklib</code> test utilities.</a>
-    </h3>
-
-    <p>
-      The <a href="#cracklib.utilities.test">dictionary test utilities</a> have
-      the location of the dictionary database hard-coded into them.  On a
-      Debian system the database is located in the directory
-      <code>/var/cache/cracklib/cracklib_dict</code> and is generated daily with the program
-      <code>/etc/cron.daily/cracklib</code>.  The location is also defined in
-      the header file <code> crack.h</code> using the constant
-      <code>CRACKLIB_DICTPATH </code> None of the subroutines in the
-      <code>cracklib</code> libraries have this location hard-coded into their
-      implementations.
-    </p>
-
-
-    <h3>
-      <a id="cracklib.dictionaries.src">Word lists for creating dictionary
-      databases.</a>
-    </h3>
-
-    <p>
-      <code>cracklib2</code> is only as good as the word dictionary database you
-      create.  Basically, you want to include any word that a malicious user
-      could guess.  It could include:
-    </p>
-
-    <ul>
-      <li>Names (including nicknames and user ids) of all users.</li>
-      <li>Names of pets, relatives, cars, ... of all users.</li>
-      <li>Computer, network, printer, ... names.</li>
-      <li>Insurance numbers, employee numbers, ... of users.</li>
-      <li>...</li>
-    </ul>
-
-    <p>
-      Debian provides a number of word lists that can be used as sources for
-      creating the <code>cracklib2</code> dictionary database.  The package <a
-      href="/cgi-bin/man2html/usr/share/man/man5/english.5.gz"><code>wenglish</code></a>
-      provides a standard ASCII word list that can be directly used.  The
-      package <a href="../ispell/ispell.html"><code>ispell</code></a> also
-      supplies a large word list but it is in binary format.  I haven't
-      figured out how to decode this binary format so that the resulting word
-      list can be used by <code>cracklib2</code>.
-    </p>
-
-    <hr/>
-
-    <p>
-      Original Copyright &copy; 1998, 1999
-      <a href="mailto:jplejacq at quoininc.com">Jean Pierre LeJacq</a>
-      <br/>
-      Currently maintained by <a href="mailto:mpitt at debian.org">Martin Pitt</a> 
-      <br/>
-      Distributed under the <a href="../../common-licenses/GPL">GNU GENERAL PUBLIC
-      LICENSE</a>.
-      <br/>
-      last-modified: Thu, 21 Oct 2003 
-    </p>
-  </body>
-</html>

Added: cracklib2/trunk/debian/cracklib-runtime.xml
===================================================================
--- cracklib2/trunk/debian/cracklib-runtime.xml	                        (rev 0)
+++ cracklib2/trunk/debian/cracklib-runtime.xml	2008-06-30 12:41:50 UTC (rev 22)
@@ -0,0 +1,195 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<article class="productsheet">
+  <title>cracklib utilities</title>
+  <articleinfo>
+    <abstract>
+      <para><application>cracklib2</application> is a library
+      containing a C function which may be used in a <ulink
+      url="/cgi-bin/man/man2html/passwd+1">passwd
+      (1)</ulink> like program. The idea is simple: try to prevent
+      users from choosing passwords that could be guessed by <ulink
+      url="http://www.crypticide.com/alecm/security/c50-faq.html"><application><filename>crack</filename></application></ulink>
+      by filtering them out, at
+      source. <application>cracklib2</application> is
+      <emphasis>not</emphasis> a replacement <ulink
+      url="/cgi-bin/man/man2html/passwd+1">passwd
+      (1)</ulink> program. <application>cracklib2</application> is a
+      <emphasis>library</emphasis>.</para>
+      <para><package>cracklib-runtime</package> contains run-time support programs which use the shared library in <package>libcrack2</package> including programs to build the password dictionary databases used by the functions in the shared library.</para>
+    </abstract>
+    <copyright>
+      <year>1998</year>
+      <year>1999</year>
+      <holder>Jean Pierre LeJacq</holder>
+    </copyright>
+    <copyright>
+      <year>2003</year>
+      <holder>Martin Pitt</holder>
+    </copyright>
+    <copyright>
+      <year>2008</year>
+      <holder>Jan Dittberner</holder>
+    </copyright>
+    <legalnotice>
+      <para>This package and this document is free software; you may
+      redistribute it and/or modify it under the terms of the GNU
+      General Public License version 2 as published by the Free
+      Software Foundation.</para>
+      <para>A copy of the GNU General Public License version 2 is
+      available as /usr/share/common-licenses/GPL-2 in the Debian
+      GNU/Linux distribution or on the World Wide Web at <ulink
+      url="http://www.gnu.org/copyleft/gpl.html">http://www.gnu.org/copyleft/gpl.html</ulink>. You
+      can also obtain it by writing to the Free Software Foundation,
+      Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
+      USA.</para>
+    </legalnotice>
+    <author>
+      <firstname>Jean Pierre</firstname>
+      <surname>LeJacq</surname>
+      <contrib>Original Debian packaging</contrib>
+      <email>jplejacq at quoininc.com</email>
+    </author>
+    <author>
+      <firstname>Martin</firstname>
+      <surname>Pitt</surname>
+      <contrib>Debian package maintainer before version 2.8.</contrib>
+      <email>mpitt at debian.org</email>
+    </author>
+    <author>
+      <firstname>Jan</firstname>
+      <surname>Dittberner</surname>
+      <contrib>Reformulation to DocBook XML, updated to reflect new
+      packaging and upstream version. Current Debian package
+      maintainer.</contrib>
+      <email>jan at dittberner.info</email>
+    </author>
+    <pubdate>$Date: 2008-06-26 21:38:06 +0200 (Do, 26 Jun 2008) $</pubdate>
+  </articleinfo>
+  <section>
+    <title>Upstream <package>cracklib2</package> utilities.</title>
+    <section>
+      <title><package>cracklib2</package> dictionary utilities.</title>
+      <section id="s-cracklib-format">
+        <title>cracklib-format</title>
+        <para><application>cracklib-format</application> takes a list
+        of text files each containing a list of words, one per line,
+        It lowercases all words, removes control charac‐ters, and
+        sorts the lists. It outputs the cleaned up list to standard
+        output.
+        </para>
+        <para>For more information see the manual page of <ulink
+        url="/cgi-bin/man/man2html?cracklib-format+8"><application>cracklib-format</application></ulink>.</para>
+      </section>
+      <section id="s-cracklib-packer">
+        <title>cracklib-packer</title>
+        <para><application>cracklib-packer</application> reads from
+        standard input a list of sorted and cleaned words and creates
+        a database from the result.</para>
+        <para>For more information see the manual page of <ulink
+        url="/cgi-bin/man/man2html?cracklib-packer+8"><application>cracklib-packer</application></ulink>.</para>
+      </section>
+      <section>
+        <title>cracklib-unpacker</title>
+        <para><application>cracklib-unpacker</application> reads from
+        a database created by <link
+        linkend="s-cracklib-packer"><application>cracklib-packer</application></link>
+        and outputs on standard output the list of words that make up
+        the database.</para>
+        <para>For more information see the manual page of <ulink
+        url="/cgi-bin/man/man2html?cracklib-unpacker+8"><application>cracklib-unpacker</application></ulink>.</para>
+      </section>
+      <section>
+        <title>create-cracklib-dict</title>
+        <para><application>create-cracklib-dict</application> takes
+        one or more word list files as arguments and converts them
+        into cracklib dictionaries for use by password checking
+        programs. The results are placed in the default compiled-in
+        dictionary location (<xref
+        linkend="s-debian-dictionary-location" />).</para>
+        <para>If you wish to store the dictionary in a different
+        location, use the <link
+        linkend="s-cracklib-format">cracklib-format</link> and <link
+        linkend="s-cracklib-packer"><application>cracklib-packer</application></link>
+        commands directly.</para>
+      </section>
+    </section>
+    <section>
+      <title><package>cracklib2</package>'s test utility
+      <application>cracklib-check.</application></title>
+      <para><application>cracklib-check</application> takes a list of
+      passwords from stdin and checks them via libcrack2’s <ulink
+      url="/cgi-bin/man/man2html/FascistCheck+3">FascistCheck</ulink>
+      sub routine.</para>
+      <para><application>cracklib-check</application> prints each
+      checked password and the corresponding result of <ulink
+      url="/cgi-bin/man/man2html/FascistCheck+3">FascistCheck</ulink>
+      to stdout. The password and the result are separated by a
+      colon.</para>
+    </section>
+  </section>
+  <section>
+    <title>Debian <package>cracklib2</package> utilities.</title>
+    <section>
+      <title>update-cracklib</title>
+      <para><application>update-cracklib</application> uses <link
+      linkend="s-cracklib-format"><application>cracklib-format</application></link>
+      and <link
+      linkend="s-cracklib-packer"><application>cracklib-packer</application></link>
+      to update the default cracklib dictionary it uses the word lists
+      configured in
+      <filename>/etc/cracklib/cracklib.conf</filename>.</para>
+      <para>For more information see the manual page of <ulink
+      url="/cgi-bin/man/man2html?update-cracklib+8"><application>cracklib-format</application></ulink>.</para>
+    </section>
+  </section>
+  <section>
+    <title>Debian dictionaries</title>
+    <para><application>cracklib2</application> uses a word database
+    that is in a binary format generated by the utilities <link
+    linkend="s-cracklib-format"><application>cracklib-format</application></link>
+    and <link
+    linkend="s-cracklib-packer"><application>cracklib-packer</application></link>. Three
+    files are created with the suffixes of .hwm, .pwd, and .pwi. These
+    files are not byte-order independent, in fact they are probably
+    architecture specific, mostly due to speed constraints.</para>
+    <section id="s-debian-dictionary-location">
+      <title>Database location for cracklib utilities.</title>
+      <para>All cracklib utilities can use a dictionary database
+      location specified as a command line argument. The utilities use
+      a default dictionary database if nothing else is specified. On a
+      Debian system the database is located in the directory
+      <filename>/var/cache/cracklib/cracklib_dict</filename> and is
+      generated daily with the program
+      <filename>/etc/cron.daily/cracklib</filename>.</para>
+    </section>
+    <section>
+      <title>Word lists for creating dictionary databases.</title>
+      <para><application>cracklib2</application> is only as good as the word dictionary database you create. Basically, you want to include any word that a malicious user could guess. It could include:
+      <itemizedlist>
+        <listitem>
+          <para>Names (including nicknames and user ids) of all users.</para>
+        </listitem>
+        <listitem>
+          <para>Names of pets, relatives, cars, ... of all users.</para>
+        </listitem>
+        <listitem>
+          <para>Computer, network, printer, ... names.</para>
+        </listitem>
+        <listitem>
+          <para>Insurance numbers, employee numbers, ... of users.  *
+          ...</para>
+        </listitem>
+      </itemizedlist>
+      </para>
+      <para>Debian provides a number of word lists that can be used as
+      sources for creating the cracklib2 dictionary database. The
+      package wenglish provides a standard ASCII word list that can be
+      directly used. The package ispell also supplies a large word
+      list but it is in binary format. I haven't figured out how to
+      decode this binary format so that the resulting word list can be
+      used by cracklib2.</para>
+    </section>
+  </section>
+</article>

Modified: cracklib2/trunk/debian/libcrack2.xml
===================================================================
--- cracklib2/trunk/debian/libcrack2.xml	2008-06-30 10:20:28 UTC (rev 21)
+++ cracklib2/trunk/debian/libcrack2.xml	2008-06-30 12:41:50 UTC (rev 22)
@@ -7,14 +7,14 @@
     <abstract>
       <para><application>cracklib2</application> is a library
       containing a C function which may be used in a <ulink
-      url="http://localhost/doc/cgi-bin/man2html/usr/share/man/man1/passwd.1.gz">passwd
+      url="/cgi-bin/man/man2html/passwd+1">passwd
       (1)</ulink> like program. The idea is simple: try to prevent
       users from choosing passwords that could be guessed by <ulink
       url="http://www.crypticide.com/alecm/security/c50-faq.html"><application><filename>crack</filename></application></ulink>
       by filtering them out, at
       source. <application>cracklib2</application> is
       <emphasis>not</emphasis> a replacement <ulink
-      url="http://localhost/doc/cgi-bin/man2html/usr/share/man/man1/passwd.1.gz">passwd
+      url="/cgi-bin/man/man2html/passwd+1">passwd
       (1)</ulink> program. <application>cracklib2</application> is a
       <emphasis>library</emphasis>.</para>
       <para><application>cracklib2</application> is an offshoot of
@@ -61,10 +61,11 @@
       Software Foundation.</para>
       <para>A copy of the GNU General Public License version 2 is
       available as /usr/share/common-licenses/GPL-2 in the Debian
-      GNU/Linux distribution or on the World Wide Web at
-      http://www.gnu.org/copyleft/gpl.html. You can also obtain it by
-      writing to the Free Software Foundation, Inc., 51 Franklin St,
-      Fifth Floor, Boston, MA 02110-1301, USA.</para>
+      GNU/Linux distribution or on the World Wide Web at <ulink
+      url="http://www.gnu.org/copyleft/gpl.html">http://www.gnu.org/copyleft/gpl.html</ulink>. You
+      can also obtain it by writing to the Free Software Foundation,
+      Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
+      USA.</para>
     </legalnotice>
     <author>
       <firstname>Jean Pierre</firstname>
@@ -75,14 +76,15 @@
     <author>
       <firstname>Martin</firstname>
       <surname>Pitt</surname>
-      <contrib>Current Debian package maintainer</contrib>
+      <contrib>Debian package maintainer before version 2.8.</contrib>
       <email>mpitt at debian.org</email>
     </author>
     <author>
       <firstname>Jan</firstname>
       <surname>Dittberner</surname>
       <contrib>Reformulation to DocBook XML, updated to reflect new
-      packaging and upstream version</contrib>
+      packaging and upstream version. Current Debian package
+      maintainer.</contrib>
       <email>jan at dittberner.info</email>
     </author>
     <pubdate>$Date$</pubdate>

Modified: cracklib2/trunk/debian/rules
===================================================================
--- cracklib2/trunk/debian/rules	2008-06-30 10:20:28 UTC (rev 21)
+++ cracklib2/trunk/debian/rules	2008-06-30 12:41:50 UTC (rev 22)
@@ -15,7 +15,7 @@
 	dh_testdir
 	mkdir -p debian/tmpbuild
 	cd debian/tmpbuild; \
-	../../configure --host=$(DEB_HOST_GNU_TYPE) --build=$(DEB_BUILD_GNU_TYPE) --prefix=/usr --disable-rpath --without-python
+	../../configure --host=$(DEB_HOST_GNU_TYPE) --build=$(DEB_BUILD_GNU_TYPE) --prefix=/usr --disable-rpath --without-python --with-default-dict=/var/cache/cracklib/cracklib_dict
 	for i in $(PYVERS); do \
 		mkdir -p debian/build$$i; \
 		cd debian/build$$i; \
@@ -32,6 +32,7 @@
 		${MAKE} -C debian/build$$i/python LDFLAGS=-L`pwd`/debian/tmpbuild/lib/.libs; \
 	done
 	xmlto -o debian/doc xhtml-nochunks debian/libcrack2.xml
+	xmlto -o debian/doc xhtml-nochunks debian/cracklib-runtime.xml
 	touch build-stamp
 
 clean:




More information about the Pkg-cracklib-commits mailing list