Imported Upstream version 0.66.1
[hcoop/debian/courier-authlib.git] / userdb / makeuserdb.html.in
index c4f01f0..dd5d00a 100644 (file)
@@ -1,10 +1,10 @@
 <?xml version="1.0"?>
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>makeuserdb</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"/><link rel="start" href="#makeuserdb" title="makeuserdb"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>makeuserdb</title><link rel="stylesheet" type="text/css" href="style.css"/><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/><link rel="home" href="#makeuserdb" title="makeuserdb"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
 
-Copyright 1998 - 2007 Double Precision, Inc.  See COPYING for distribution
+Copyright 1998 - 2009 Double Precision, Inc.  See COPYING for distribution
 information.
 
---></head><body><div class="refentry" lang="en" xml:lang="en"><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" lang="en" xml:lang="en"><a id="id418905" 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="idm247889088800" 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" lang="en" xml:lang="en"><a id="id383715" shape="rect"> </a><h3>Format of <code class="filename">@userdb@</code></h3><p>
+<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> 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" lang="en" xml:lang="en"><a id="id384001" 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="idm247889191520" 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" lang="en" xml:lang="en"><a id="id428252" shape="rect"> </a><h3>CONVERTING <code class="filename">/etc/passwd</code>
+or world permissions.</p></div><div class="refsect2"><a id="idm247889185648" 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" lang="en" xml:lang="en"><a id="id428564" 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="idm247883799232" 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" lang="en" xml:lang="en"><a id="id428604" 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="idm247883794480" 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" lang="en" xml:lang="en"><a id="id428619" shape="rect"> </a><h2>SEE ALSO</h2><p>
+not work with some networks.</p></div><div class="refsect1"><a id="idm247883792656" 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>,