Import Debian changes 0.66.4-9
[hcoop/debian/courier-authlib.git] / userdb / makeuserdb.html.in
index dd5d00a..0f6dfd9 100644 (file)
@@ -4,7 +4,7 @@
 Copyright 1998 - 2009 Double Precision, Inc.  See COPYING for distribution
 information.
 
---></head><body><div class="refentry"><a id="makeuserdb" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>makeuserdb — create @userdb@</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">makeuserdb</code>  [-f <em class="replaceable"><code>filename</code></em>]</p></div><div class="cmdsynopsis"><p><code class="command">pw2userdb</code> </p></div><div class="cmdsynopsis"><p><code class="command">vchkpw2userdb</code>  [--vpopmailhome=<em class="replaceable"><code>dir</code></em>] [--todir=<em class="replaceable"><code>dir</code></em>]</p></div></div><div class="refsect1"><a id="idm247889088800" shape="rect"> </a><h2>DESCRIPTION</h2><p>
+--></head><body><div class="refentry"><a id="makeuserdb" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>makeuserdb — create @userdb@</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">makeuserdb</code>  [-f <em class="replaceable"><code>filename</code></em>]</p></div><div class="cmdsynopsis"><p><code class="command">pw2userdb</code> </p></div><div class="cmdsynopsis"><p><code class="command">vchkpw2userdb</code>  [--vpopmailhome=<em class="replaceable"><code>dir</code></em>] [--todir=<em class="replaceable"><code>dir</code></em>]</p></div></div><div class="refsect1"><a id="idm255236535600" shape="rect"> </a><h2>DESCRIPTION</h2><p>
 <span class="command"><strong>makeuserdb</strong></span> creates <code class="filename">@userdb@.dat</code> from
 the contents of <code class="filename">@userdb@</code>.
 <code class="filename">@userdb@</code>'s contents are described later in this document.
@@ -30,7 +30,7 @@ The <code class="option">-f</code> option creates
 <code class="filename"><em class="replaceable"><code>filename</code></em>.dat</code> from
 <code class="filename"><em class="replaceable"><code>filename</code></em></code>, instead of the
 default <code class="filename">@userdb@.dat</code> from
-<code class="filename">@userdb@</code>.</p><div class="refsect2"><a id="idm247884945760" shape="rect"> </a><h3>Format of <code class="filename">@userdb@</code></h3><p>
+<code class="filename">@userdb@</code>.</p><div class="refsect2"><a id="idm255241546448" shape="rect"> </a><h3>Format of <code class="filename">@userdb@</code></h3><p>
 <code class="filename">@userdb@</code> is a plain text file that can be created using
 any text editor. Blank lines are ignored. Lines that start with the #
 character are comments, and are also ignored.
@@ -92,7 +92,7 @@ software-based Maildir quota enforcement
 mechanism which requires additional setup and configuration.
 See
 <a class="ulink" href="maildirquota.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildirquota</span>(7)</span></a>
-for additional information.</p></blockquote></div></div><div class="refsect2"><a id="idm247889191520" shape="rect"> </a><h3><code class="filename">@userdb@shadow.dat</code></h3><p>
+for additional information.</p></blockquote></div></div><div class="refsect2"><a id="idm255236218720" shape="rect"> </a><h3><code class="filename">@userdb@shadow.dat</code></h3><p>
 All fields whose name ends with 'pw' will NOT copied to
 <code class="filename">@userdb@.dat</code>. These fields will be copied to
 <code class="filename">@userdb@shadow.dat</code>.
@@ -100,7 +100,7 @@ All fields whose name ends with 'pw' will NOT copied to
 without any group and world permissions.
 Note that <span class="command"><strong>makeuserdb</strong></span> reports an error
 if <span class="command"><strong>@userdb@</strong></span> has any group
-or world permissions.</p></div><div class="refsect2"><a id="idm247889185648" shape="rect"> </a><h3>CONVERTING <code class="filename">/etc/passwd</code>
+or world permissions.</p></div><div class="refsect2"><a id="idm255236213456" shape="rect"> </a><h3>CONVERTING <code class="filename">/etc/passwd</code>
 and vpopmail to <code class="filename">@userdb@</code> format</h3><p>
 <span class="command"><strong>pw2userdb</strong></span> reads the <code class="filename">/etc/passwd</code> and
 <code class="filename">/etc/shadow</code> files and converts all entries to the
@@ -178,16 +178,16 @@ replace one of the redundant files with a soft link to
 <code class="filename">/dev/null</code>.
 This allows you to run
 <span class="command"><strong>vchkpw2userdb</strong></span> without having to go in and
-cleaning up again, afterwards.</p></div></div><div class="refsect1"><a id="idm247883799232" shape="rect"> </a><h2>FILES</h2><div class="literallayout"><p><br clear="none"/>
+cleaning up again, afterwards.</p></div></div><div class="refsect1"><a id="idm255236176528" shape="rect"> </a><h2>FILES</h2><div class="literallayout"><p><br clear="none"/>
 <code class="filename">@userdb@</code><br clear="none"/>
 <code class="filename">@userdb@.dat</code><br clear="none"/>
 <code class="filename">@userdb@shadow.dat</code><br clear="none"/>
 <code class="filename">@tmpdir@/userdb.tmp</code> - temporary file<br clear="none"/>
 <code class="filename">@tmpdir@/userdbshadow.tmp</code> - temporary file<br clear="none"/>
-</p></div></div><div class="refsect1"><a id="idm247883794480" shape="rect"> </a><h2>BUGS</h2><p><span class="command"><strong>makeuserdb</strong></span> is a Perl script, and uses Perl's portable
+</p></div></div><div class="refsect1"><a id="idm255236171776" shape="rect"> </a><h2>BUGS</h2><p><span class="command"><strong>makeuserdb</strong></span> is a Perl script, and uses Perl's portable
 locking.
 Perl's documentation notes that certain combinations of locking options may
-not work with some networks.</p></div><div class="refsect1"><a id="idm247883792656" shape="rect"> </a><h2>SEE ALSO</h2><p>
+not work with some networks.</p></div><div class="refsect1"><a id="idm255236169952" shape="rect"> </a><h2>SEE ALSO</h2><p>
 <a class="ulink" href="userdb.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">userdb</span>(8)</span></a>,
 <a class="ulink" href="maildrop.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">maildrop</span>(8)</span></a>,
 <a class="ulink" href="courier.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">courier</span>(8)</span></a>,