Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: svn commit: r1751351 - in /httpd/httpd/trunk/docs/manual/programs:
 htdbm.html.en htdbm.xml
Date: Mon, 04 Jul 2016 17:19:08 -0000
To: cvs@httpd.apache.org
From: rbowen@apache.org
Message-Id: <20160704171908.B8C233A031D@svn01-us-west.apache.org>
archived-at: Mon, 04 Jul 2016 17:19:15 -0000

Author: rbowen
Date: Mon Jul  4 17:19:08 2016
New Revision: 1751351

URL: http://svn.apache.org/viewvc?rev=1751351&view=rev
Log:
Give an example of converting a password file from one format to the
other.

Modified:
    httpd/httpd/trunk/docs/manual/programs/htdbm.html.en
    httpd/httpd/trunk/docs/manual/programs/htdbm.xml

Modified: httpd/httpd/trunk/docs/manual/programs/htdbm.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htdbm.html.en?rev=1751351&r1=1751350&r2=1751351&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htdbm.html.en (original)
+++ httpd/httpd/trunk/docs/manual/programs/htdbm.html.en Mon Jul  4 17:19:08 2016
@@ -279,6 +279,20 @@
 
     <p>Encrypts the password from the command line (<code>Pwd4Steve</code>)
     using the MD5 algorithm, and stores it in the specified file.</p>
+
+    <p>To convert an existing text file <code>htpasswd</code>-generated
+    password file to a <code>dbm</code> file, use <code>awk</code> to
+    feed each line of that file into <code>htdbm</code>:</p>
+
+    <div class="example"><p><code>
+      htdbm -cbp passwords.dbm bogus bogus
+      awk &#8216;BEGIN { FS=&#8221;:&#8221; }; {system (&#8220;htdbm -bp passwords.dbm &#8221; $1 &#8221; &#8221; $2)}&#8217; passwords
+      htdbm -x bogus
+    </code></p></div>
+
+    <p>The first line creates a new password database with a temporary
+    placeholder entry, and the thrid line removes that placeholder.</p>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="security" id="security">Security Considerations</a></h2>

Modified: httpd/httpd/trunk/docs/manual/programs/htdbm.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htdbm.xml?rev=1751351&r1=1751350&r2=1751351&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htdbm.xml (original)
+++ httpd/httpd/trunk/docs/manual/programs/htdbm.xml Mon Jul  4 17:19:08 2016
@@ -272,6 +272,20 @@
 
     <p>Encrypts the password from the command line (<code>Pwd4Steve</code>)
     using the MD5 algorithm, and stores it in the specified file.</p>
+
+    <p>To convert an existing text file <code>htpasswd</code>-generated
+    password file to a <code>dbm</code> file, use <code>awk</code> to
+    feed each line of that file into <code>htdbm</code>:</p>
+
+    <example>
+      htdbm -cbp passwords.dbm bogus bogus
+      awk âBEGIN { FS=â:â }; {system (âhtdbm -bp passwords.dbm â $1 â â $2)}â passwords
+      htdbm -x bogus
+    </example>
+
+    <p>The first line creates a new password database with a temporary
+    placeholder entry, and the thrid line removes that placeholder.</p>
+
 </section>
 
 <section id="security"><title>Security Considerations</title>