Import Upstream version 0.66.4
[hcoop/debian/courier-authlib.git] / userdb / userdb.html.in
index c5c3012..6f379c5 100644 (file)
@@ -4,7 +4,7 @@
 Copyright 1998 - 2009 Double Precision, Inc.  See COPYING for distribution
 information.
 
---></head><body><div class="refentry"><a id="userdb" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>userdb — manipulate @userdb@</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  set  {<em class="replaceable"><code>field</code></em>=<em class="replaceable"><code>value</code></em>...}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  unset  {<em class="replaceable"><code>field</code></em>...}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  del </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>path/addr</code></em>} [ set  |   unset  |   del ]  ... </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -f  {<em class="replaceable"><code>file</code></em>} {<em class="replaceable"><code>adr</code></em>} [ set  |   unset  |   del ]  ... </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show  {<em class="replaceable"><code>path</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show  {<em class="replaceable"><code>path</code></em>} {<em class="replaceable"><code>addr</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show   -f  {<em class="replaceable"><code>file</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show   -f  {<em class="replaceable"><code>file</code></em>} {<em class="replaceable"><code>addr</code></em>}</p></div></div><div class="refsect1"><a id="idm247888864656" shape="rect"> </a><h2>DESCRIPTION</h2><p>
+--></head><body><div class="refentry"><a id="userdb" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>userdb — manipulate @userdb@</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  set  {<em class="replaceable"><code>field</code></em>=<em class="replaceable"><code>value</code></em>...}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  unset  {<em class="replaceable"><code>field</code></em>...}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>addr</code></em>}  del </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>  {<em class="replaceable"><code>path/addr</code></em>} [ set  |   unset  |   del ]  ... </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -f  {<em class="replaceable"><code>file</code></em>} {<em class="replaceable"><code>adr</code></em>} [ set  |   unset  |   del ]  ... </p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show  {<em class="replaceable"><code>path</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show  {<em class="replaceable"><code>path</code></em>} {<em class="replaceable"><code>addr</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show   -f  {<em class="replaceable"><code>file</code></em>}</p></div><div class="cmdsynopsis"><p><code class="command">userdb</code>   -show   -f  {<em class="replaceable"><code>file</code></em>} {<em class="replaceable"><code>addr</code></em>}</p></div></div><div class="refsect1"><a id="idm255234219424" shape="rect"> </a><h2>DESCRIPTION</h2><p>
 <span class="command"><strong>userdb</strong></span> is a convenient script to individually manipulate
 entries in <code class="filename">@userdb@</code>. See
 <a class="ulink" href="makeuserdb.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">makeuserdb</span>(8)</span></a>
@@ -62,7 +62,7 @@ command. If <span class="command"><strong>userdb</strong></span> is being
 executed by a script, the value can be provided on standard input.</p><p>Use "<em class="parameter"><code>unset</code></em>" to delete fields from an existing
 record. Use
 "<em class="parameter"><code>del</code></em>" to delete all fields in the existing record,
-plus the record itself.</p><div class="refsect2"><a id="idm247883457424" shape="rect"> </a><h3>DISPLAYING <code class="filename">@userdb@</code></h3><p>
+plus the record itself.</p><div class="refsect2"><a id="idm255234187376" shape="rect"> </a><h3>DISPLAYING <code class="filename">@userdb@</code></h3><p>
 If the first argument to userdb
 is <em class="parameter"><code>-show</code></em>, <span class="command"><strong>userdb</strong></span>
 displays the contents of <code class="filename">@userdb@</code>. If
@@ -80,13 +80,13 @@ output, containing all addresses found in the file, on per line. If
 <em class="parameter"><code><em class="replaceable"><code>addr</code></em></code></em> is specified,
 <span class="command"><strong>userdb</strong></span> produces a list, on standard output, of
 all the fields in <code class="filename">@userdb@</code> for this
-<em class="parameter"><code><em class="replaceable"><code>addr</code></em></code></em>.</p></div><div class="refsect2"><a id="idm247883446032" shape="rect"> </a><h3>REBUILDING <code class="filename">@userdb@.dat</code></h3><p>
+<em class="parameter"><code><em class="replaceable"><code>addr</code></em></code></em>.</p></div><div class="refsect2"><a id="idm255234175984" shape="rect"> </a><h3>REBUILDING <code class="filename">@userdb@.dat</code></h3><p>
 The actual virtual account/address database is
 <code class="filename">@userdb@.dat</code>.
 This is a binary database file. <span class="command"><strong>@userdb@</strong></span> is the plain text
 version. After running <span class="command"><strong>userdb</strong></span>, execute the
 <a class="ulink" href="makeuserdb.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">makeuserdb</span>(8)</span></a> command to rebuild
-<code class="filename">@userdb@.dat</code> for the changes to take effect.</p></div></div><div class="refsect1"><a id="idm247883440624" shape="rect"> </a><h2>BUGS</h2><p>
+<code class="filename">@userdb@.dat</code> for the changes to take effect.</p></div></div><div class="refsect1"><a id="idm255234170576" shape="rect"> </a><h2>BUGS</h2><p>
 <em class="parameter"><code><em class="replaceable"><code>addr</code></em></code></em> must be unique.
 If <code class="filename">@userdb@</code> is a subdirectory,
 it's possible to create the same
@@ -95,10 +95,10 @@ in different files in the subdirectory.
 This is an error that is not currently detected by <span class="command"><strong>userdb</strong></span>,
 however the subsequent
 <a class="ulink" href="makeuserdb.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">makeuserdb</span>(8)</span></a> command
-will fail with an error message.</p></div><div class="refsect1"><a id="idm247883435472" shape="rect"> </a><h2>FILES</h2><p>
+will fail with an error message.</p></div><div class="refsect1"><a id="idm255234165424" shape="rect"> </a><h2>FILES</h2><p>
 <code class="filename"> @userdb@</code> - plain text file, or directory of plain text files</p><p>
 <code class="filename"> .lock.filename</code> - lock file for <code class="filename">filename</code></p><p>
-<code class="filename"> .tmp.filename</code> - temporary file used to create new contents of <code class="filename">filename</code></p></div><div class="refsect1"><a id="idm247883430688" shape="rect"> </a><h2>SEE ALSO</h2><p>
+<code class="filename"> .tmp.filename</code> - temporary file used to create new contents of <code class="filename">filename</code></p></div><div class="refsect1"><a id="idm255234160640" shape="rect"> </a><h2>SEE ALSO</h2><p>
 <a class="ulink" href="makeuserdb.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">makeuserdb</span>(8)</span></a>,
  
 <a class="ulink" href="userdbpw.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">userdbpw</span>(8)</span></a></p></div></div></body></html>