doc/FAQ.html
changeset 2 b3afb9f1e801
parent 0 6f7a81934006
equal deleted inserted replaced
1:30113bfbe723 2:b3afb9f1e801
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
       
     2 <HTML>
     1 <HTML>
       
     2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
       
     3 <!-- Created on December, 29  2004 by texi2html 1.64 -->
       
     4 <!-- 
       
     5 Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
       
     6             Karl Berry  <karl@freefriends.org>
       
     7             Olaf Bachmann <obachman@mathematik.uni-kl.de>
       
     8             and many others.
       
     9 Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
       
    10 Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
       
    11  
       
    12 -->
     3 <HEAD>
    13 <HEAD>
     4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
    14 <TITLE>Vmailmgr FAQ: </TITLE>
     5  <TITLE>  VMailMgr FAQ</TITLE>
    15 
     6 
    16 <META NAME="description" CONTENT="Vmailmgr FAQ: ">
       
    17 <META NAME="keywords" CONTENT="Vmailmgr FAQ: ">
       
    18 <META NAME="resource-type" CONTENT="document">
       
    19 <META NAME="distribution" CONTENT="global">
       
    20 <META NAME="Generator" CONTENT="texi2html 1.64">
     7 
    21 
     8 </HEAD>
    22 </HEAD>
     9 <BODY>
    23 
    10 <H1>  VMailMgr FAQ</H1>
    24 <BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
    11 
    25 
    12 <H2>Bruce Guenter 
    26 <A NAME="SEC1"></A>
    13 <A HREF="mailto:bruceg@em.ca">mailto:bruceg@em.ca</A>,
    27 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    14   Dan Kuykendall 
    28 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> &lt; </A>]</TD>
    15 <A HREF="mailto:dan@kuykendall.org">mailto:dan@kuykendall.org</A></H2>  v1.0, 23 April 2000
    29 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC2"> &gt; </A>]</TD>
    16 <P><HR>
    30 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
    17 <EM>  VMailMgr Frequently Asked Questions.</EM>
    31 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
    18 <HR>
    32 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
    19 <H2><A NAME="s1">1. Building and Installing</A></H2>
    33 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
    20 
    34 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
    21 <H2>1.1 What compiler and libraries do I need to build vmailmgr?</H2>
    35 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
    22 
    36 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
    23 <P>You will need a working C and C++ compiler and linker. You will not
    37 </TR></TABLE>
       
    38 <P>
       
    39 
       
    40 Copyright (C) 1998 Bruce Guenter
       
    41 </P><P>
       
    42 
       
    43 VMailMgr Frequently Asked Questions.
       
    44 </P><P>
       
    45 
       
    46 <H1> 1. Building and Installing </H1>
       
    47 <!--docid::SEC1::-->
       
    48 <P>
       
    49 
       
    50 <HR SIZE="6">
       
    51 <A NAME="SEC2"></A>
       
    52 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
    53 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> &lt; </A>]</TD>
       
    54 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC3"> &gt; </A>]</TD>
       
    55 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
    56 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
    57 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
    58 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
    59 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
    60 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
    61 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
    62 </TR></TABLE>
       
    63 <H2> 1.1 What compiler and libraries do I need to build vmailmgr? </H2>
       
    64 <!--docid::SEC2::-->
       
    65 <P>
       
    66 
       
    67 You will need a working C and C++ compiler and linker. You will not
    24 need any C++ libraries.  The package is being developed under Linux
    68 need any C++ libraries.  The package is being developed under Linux
    25 using egcs and glibc version 2, and may rely on some gcc/g++
    69 using egcs and glibc version 2, and may rely on some gcc/g++
    26 extensions.
    70 extensions.
    27 <H2>1.2 Does vmailmgr work with shadow passwords?</H2>
    71 </P><P>
    28 
    72 
    29 <P>This package should work without changes both with and without
    73 <HR SIZE="6">
       
    74 <A NAME="SEC3"></A>
       
    75 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
    76 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC2"> &lt; </A>]</TD>
       
    77 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC4"> &gt; </A>]</TD>
       
    78 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
    79 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
    80 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
    81 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
    82 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
    83 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
    84 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
    85 </TR></TABLE>
       
    86 <H2> 1.2 Does vmailmgr work with shadow passwords? </H2>
       
    87 <!--docid::SEC3::-->
       
    88 <P>
       
    89 
       
    90 This package should work without changes both with and without
    30 shadow passwords as long as the shadow password libraries are
    91 shadow passwords as long as the shadow password libraries are
    31 present when this package is built. The `configure' script will
    92 present when this package is built. The <CODE>configure</CODE> script will
    32 detect what method of shadow passwords are being used and the
    93 detect what method of shadow passwords are being used and the
    33 programs will be built accordingly.
    94 programs will be built accordingly.
    34 <H2>1.3 Does vmailmgr support IMAP?</H2>
    95 </P><P>
    35 
    96 
    36 <P>Yes, vmailmgr supports Courier-IMAP.  Some minor steps are needed to
    97 <HR SIZE="6">
       
    98 <A NAME="SEC4"></A>
       
    99 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   100 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC3"> &lt; </A>]</TD>
       
   101 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC5"> &gt; </A>]</TD>
       
   102 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   103 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   104 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   105 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   106 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   107 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   108 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   109 </TR></TABLE>
       
   110 <H2> 1.3 Does vmailmgr support IMAP? </H2>
       
   111 <!--docid::SEC4::-->
       
   112 <P>
       
   113 
       
   114 Yes, vmailmgr supports Courier-IMAP.  Some minor steps are needed to
    37 make them work, the steps are in the next section of this file.
   115 make them work, the steps are in the next section of this file.
    38 <H2><A NAME="s2">2. Setup and Configuration</A></H2>
   116 </P><P>
    39 
   117 
    40 <H2>2.1 What other software is needed to run vmailmgr?</H2>
   118 <HR SIZE="6">
    41 
   119 <A NAME="SEC5"></A>
    42 <P>VMailMgr is based around qmail's handling of virtual users, and as
   120 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    43 such requires qmail for its operation. If you wish to use the `init'
   121 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC4"> &lt; </A>]</TD>
    44 file to start/stop vmailmgrd or are installing the RPM package,
   122 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC6"> &gt; </A>]</TD>
       
   123 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   124 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   125 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   126 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   127 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   128 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   129 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   130 </TR></TABLE>
       
   131 <H1> 2. Setup and Configuration </H1>
       
   132 <!--docid::SEC5::-->
       
   133 <P>
       
   134 
       
   135 <HR SIZE="6">
       
   136 <A NAME="SEC6"></A>
       
   137 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   138 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC5"> &lt; </A>]</TD>
       
   139 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC7"> &gt; </A>]</TD>
       
   140 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   141 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   142 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   143 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   144 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   145 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   146 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   147 </TR></TABLE>
       
   148 <H2> 2.1 What other software is needed to run vmailmgr? </H2>
       
   149 <!--docid::SEC6::-->
       
   150 <P>
       
   151 
       
   152 VMailMgr is based around qmail's handling of virtual users, and as
       
   153 such requires qmail for its operation. If you wish to use the <CODE>init</CODE>
       
   154 file to start/stop <CODE>vmailmgrd</CODE> or are installing the RPM package,
    45 supervise-scripts version 2.2 (or later, available at 
   155 supervise-scripts version 2.2 (or later, available at 
    46 <A HREF="http://em.ca/~bruceg/supervise-scripts/">http://em.ca/~bruceg/supervise-scripts/</A>) and daemontools 0.60
   156 <A HREF="http://untroubled.org/supervise-scripts/">http://untroubled.org/supervise-scripts/</A>)
    47 (or later, available at 
   157 and daemontools 0.60 (or later, available at 
    48 <A HREF="http://em.ca/~bruceg/rpms/daemontools/">http://em.ca/~bruceg/rpms/daemontools/</A>) packages are
   158 <A HREF="http://untroubled.org/rpms/daemontools/">http://untroubled.org/rpms/daemontools/</A>)
    49 required.  If you need to use the <CODE>vmailmgrd</CODE> daemon, you
   159 packages are required.  If you need to use the <CODE>vmailmgrd</CODE> daemon, you 
    50 will also need the <CODE>unixserver</CODE> program, from the ucspi-unix
   160 will also need the <CODE>unixserver</CODE> program, from the ucspi-unix package, 
    51 package, available at 
   161 available at
    52 <A HREF="http://em.ca/~bruceg/ucspi-unix/">http://em.ca/~bruceg/ucspi-unix/</A>.
   162 <A HREF="http://untroubled.org/ucspi-unix/">http://untroubled.org/ucspi-unix/</A>.
    53 <P>If you want to use the autoresponse feature, I recommend the use of
   163 </P><P>
       
   164 
       
   165 If you want to use the autoresponse feature, I recommend the use of
    54 my own autoresponder program, <CODE>qmail-autoresponder</CODE> available
   166 my own autoresponder program, <CODE>qmail-autoresponder</CODE> available
    55 at 
   167 at 
    56 <A HREF="http://em.ca/~bruceg/qmail-autoresponder/">http://em.ca/~bruceg/qmail-autoresponder/</A>.
   168 <A HREF="http://untroubled.org/qmail-autoresponder/">http://untroubled.org/qmail-autoresponder/</A>.
    57 <H2>2.2 How do I record the output of vmailmgrd with syslog?</H2>
   169 </P><P>
    58 
   170 
    59 <P>Output from vmailmgrd can be recorded by either splogger (part of
   171 <HR SIZE="6">
    60 qmail) or with the logger that comes with several flavours of
   172 <A NAME="SEC7"></A>
    61 UNIX. To use splogger, pipe the output of vmailmgrd into the command
   173 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    62 `splogger vmailmgrd'. This will timestamp each entry and tag them
   174 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC6"> &lt; </A>]</TD>
    63 with the word `vmailmgrd'. By default, splogger logs to facility 2
   175 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC8"> &gt; </A>]</TD>
    64 (mail). To use logger, pipe the output of vmailmgrd into the
   176 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
    65 comamand `<CODE>logger -t vmailmgrd -p mail.notice</CODE>'. See the
   177 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
    66 respective man pages of these two programs for more information.
   178 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
    67 <P>Note: The use of syslog for logging messages is strongly discouraged
   179 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
    68 due to problems with inefficent and buggy implementation of syslog.
   180 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
    69 <H2>2.3 How do I record the output of vmailmgrd with multilog?</H2>
   181 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
    70 
   182 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
    71 <P>Make a directory into which the output will go, for example
   183 </TR></TABLE>
    72 `<CODE>/var/log/vmailmgrd</CODE>'. Pipe the output of vmailmgrd into the
   184 <H2> 2.2 How do I record the output of vmailmgrd with syslog? </H2>
    73 command `<CODE>multilog t /var/log/vmailmgrd</CODE>'. See the
   185 <!--docid::SEC7::-->
    74 documentation for multilog for more information on how to adjust its
   186 <P>
       
   187 
       
   188 Output from <CODE>vmailmgrd</CODE> can be recorded by either <CODE>splogger</CODE> (part of 
       
   189 qmail) or with the logger that comes with several flavours of UNIX. To use 
       
   190 <CODE>splogger</CODE>, pipe the output of <CODE>vmailmgrd</CODE> into the command 
       
   191 <SAMP>`splogger vmailmgrd'</SAMP>. This will timestamp each entry and tag them with the 
       
   192 word <SAMP>`vmailmgrd'</SAMP>. By default, <CODE>splogger</CODE> logs to facility 2 (mail). To 
       
   193 use <CODE>logger</CODE>, pipe the output of <CODE>vmailmgrd</CODE> into the command 
       
   194 <SAMP>`logger -t vmailmgrd -p mail.notice'</SAMP>. 
       
   195 See the respective man pages of these two programs for more information.
       
   196 </P><P>
       
   197 
       
   198 Note: The use of <CODE>syslog</CODE> for logging messages is strongly discouraged
       
   199 due to problems with inefficent and buggy implementation of <CODE>syslog</CODE>.
       
   200 </P><P>
       
   201 
       
   202 <HR SIZE="6">
       
   203 <A NAME="SEC8"></A>
       
   204 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   205 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC7"> &lt; </A>]</TD>
       
   206 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC9"> &gt; </A>]</TD>
       
   207 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   208 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   209 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   210 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   211 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   212 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   213 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   214 </TR></TABLE>
       
   215 <H2> 2.3 How do I record the output of vmailmgrd with multilog? </H2>
       
   216 <!--docid::SEC8::-->
       
   217 <P>
       
   218 
       
   219 Make a directory into which the output will go, for example
       
   220 <TT>`/var/log/vmailmgrd'</TT>. Pipe the output of <CODE>vmailmgrd</CODE> into the
       
   221 command <SAMP>`multilog t /var/log/vmailmgrd'</SAMP>. See the
       
   222 documentation for <CODE>multilog</CODE> for more information on how to adjust its
    75 output.
   223 output.
    76 <H2>2.4 How do I setup VMmailMgr IMAP support?</H2>
   224 </P><P>
    77 
   225 
    78 <P>VMailMgr supports Courier-IMAP, but Courier-IMAP does not auto
   226 <HR SIZE="6">
       
   227 <A NAME="SEC9"></A>
       
   228 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   229 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC8"> &lt; </A>]</TD>
       
   230 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC10"> &gt; </A>]</TD>
       
   231 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   232 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   233 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   234 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   235 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   236 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   237 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   238 </TR></TABLE>
       
   239 <H2> 2.4 How do I setup VMmailMgr IMAP support? </H2>
       
   240 <!--docid::SEC9::-->
       
   241 <P>
       
   242 
       
   243 VMailMgr supports Courier-IMAP, but Courier-IMAP does not auto
    79 detect VMailMgr.  This means that some minor work is required for
   244 detect VMailMgr.  This means that some minor work is required for
    80 making the two work together.
   245 making the two work together.
    81 <UL>
   246 </P><P>
    82 <LI>You must copy `<CODE>/usr/local/bin/authvmailmgr</CODE>` to
   247 
    83 `<CODE>/usr/lib/courier-imap/libexec/authlib/authvmailmgr</CODE>`.</LI>
   248 <UL>
    84 <LI>Then modify the `<CODE>AUTHMODULES</CODE>` statement in
   249 <LI>
    85 `<CODE>/usr/lib/courier-imap/etc/imapd.config</CODE>` and add
   250 You must copy <TT>`/usr/local/bin/authvmailmgr'</TT> to
    86 `<CODE>authvmailmgr</CODE>` as the first authentication module.</LI>
   251 <TT>`/usr/lib/courier-imap/libexec/authlib/authvmailmgr'</TT>.
       
   252 <P>
       
   253 
       
   254 <LI>
       
   255 Then modify the <CODE>AUTHMODULES</CODE> statement in
       
   256 <TT>`/usr/lib/courier-imap/etc/imapd.config'</TT> and add
       
   257 <KBD>authvmailmgr</KBD> as the first authentication module.
       
   258 <P>
       
   259 
    87 </UL>
   260 </UL>
    88 <H2>2.5 Upgrading from Previous Versions</H2>
   261 <P>
    89 
   262 
    90 <P>If you are upgrading from an older version, you may need to make
   263 <HR SIZE="6">
       
   264 <A NAME="SEC10"></A>
       
   265 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   266 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC9"> &lt; </A>]</TD>
       
   267 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC11"> &gt; </A>]</TD>
       
   268 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   269 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   270 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   271 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   272 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   273 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   274 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   275 </TR></TABLE>
       
   276 <H2> 2.5 Upgrading from Previous Versions </H2>
       
   277 <!--docid::SEC10::-->
       
   278 <P>
       
   279 
       
   280 If you are upgrading from an older version, you may need to make
    91 some changes to your system before or after doing the upgrade. The
   281 some changes to your system before or after doing the upgrade. The
    92 following table outlines the necessary changes. Note that you need
   282 following table outlines the necessary changes. Note that you need
    93 to follow the instructions for all later versions of the software.
   283 to follow the instructions for all later versions of the software.
    94 <P>If you are upgrading from version: 
   284 </P><P>
    95 <DL>
   285 
    96 <DT><B>0.96.6 or earlier</B><DD><P>The `vmailmgrd' daemon needs to be run by unixserver, as opposed
   286 <HR SIZE="6">
       
   287 <A NAME="SEC11"></A>
       
   288 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   289 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC10"> &lt; </A>]</TD>
       
   290 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC12"> &gt; </A>]</TD>
       
   291 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   292 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   293 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   294 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   295 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   296 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   297 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   298 </TR></TABLE>
       
   299 <H3> 2.5.1 Upgrading from version 0.96.6 or earlier </H3>
       
   300 <!--docid::SEC11::-->
       
   301 <P>
       
   302 
       
   303 The <CODE>vmailmgrd</CODE> daemon needs to be run by unixserver, as opposed
    97 to being a stand-alone program previously.
   304 to being a stand-alone program previously.
    98 <DT><B>0.96.2 or earlier</B><DD><P>Make sure the `vmailmgrd' daemon and vmailmgr CGIs are disabled
   305 </P><P>
       
   306 
       
   307 <HR SIZE="6">
       
   308 <A NAME="SEC12"></A>
       
   309 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   310 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC11"> &lt; </A>]</TD>
       
   311 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC13"> &gt; </A>]</TD>
       
   312 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   313 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   314 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   315 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   316 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   317 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   318 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   319 </TR></TABLE>
       
   320 <H3> 2.5.2 Upgrading from version 0.96.2 or earlier </H3>
       
   321 <!--docid::SEC12::-->
       
   322 <P>
       
   323 
       
   324 Make sure the <CODE>vmailmgrd</CODE> daemon and vmailmgr CGIs are disabled
    99 before upgrading, and upgrade them along with the main
   325 before upgrading, and upgrade them along with the main
   100 package. Changes were made to the daemon interface that will
   326 package. Changes were made to the daemon interface that will
   101 cause adding users and aliases to flake out. As well, the
   327 cause adding users and aliases to flake out. As well, the
   102 listdomain interface was completely redone.
   328 listdomain interface was completely redone.
   103 <P>
   329 </P><P>
   104 <DT><B>0.94 or earlier, using the POP bulletin facility</B><DD><P>The POP bulletin facility has been moved into a stand-alone
   330 
   105 program that needs to be executed through `checkvpw-postsetuid'.
   331 <HR SIZE="6">
   106 <P>
   332 <A NAME="SEC13"></A>
   107 <DT><B>0.93 or earlier</B><DD><P>If you do not use the CGIs, you no longer need to run the
   333 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   108 `vmailmgrd' daemon.
   334 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC12"> &lt; </A>]</TD>
   109 <P>
   335 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC14"> &gt; </A>]</TD>
   110 <DT><B>0.92.2 or earlier</B><DD><P>The configuration changed from reading a single file to reading a
   336 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
   111 set of files in a directory. Read the configuration documentation
   337 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
   112 and run the program `vconf2dir'.
   338 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   113 <P>
   339 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
   114 <DT><B>0.90.2 or earlier</B><DD><P>The name of the user to which mail to an unknown user is
   340 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
   115 delivered changed from `*' to `+'. If you were using this
   341 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   342 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   343 </TR></TABLE>
       
   344 <H3> 2.5.3 Upgrading from version 0.94 or earlier, using the POP bulletin facility </H3>
       
   345 <!--docid::SEC13::-->
       
   346 <P>
       
   347 
       
   348 The POP bulletin facility has been moved into a stand-alone
       
   349 program that needs to be executed through <CODE>checkvpw-postsetuid</CODE>.
       
   350 </P><P>
       
   351 
       
   352 <HR SIZE="6">
       
   353 <A NAME="SEC14"></A>
       
   354 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   355 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC13"> &lt; </A>]</TD>
       
   356 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC15"> &gt; </A>]</TD>
       
   357 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   358 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   359 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   360 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   361 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   362 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   363 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   364 </TR></TABLE>
       
   365 <H3> 2.5.4 Upgrading from version 0.93 or earlier </H3>
       
   366 <!--docid::SEC14::-->
       
   367 <P>
       
   368 
       
   369 If you do not use the CGIs, you no longer need to run the
       
   370 <CODE>vmailmgrd</CODE> daemon.
       
   371 </P><P>
       
   372 
       
   373 <HR SIZE="6">
       
   374 <A NAME="SEC15"></A>
       
   375 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   376 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC14"> &lt; </A>]</TD>
       
   377 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC16"> &gt; </A>]</TD>
       
   378 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   379 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   380 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   381 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   382 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   383 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   384 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   385 </TR></TABLE>
       
   386 <H3> 2.5.5 Upgrading from version 0.92.2 or earlier </H3>
       
   387 <!--docid::SEC15::-->
       
   388 <P>
       
   389 
       
   390 The configuration changed from reading a single file to reading a
       
   391 set of files in a directory.  Read the configuration documentation
       
   392 and run the program <CODE>vconf2dir</CODE>.
       
   393 </P><P>
       
   394 
       
   395 <HR SIZE="6">
       
   396 <A NAME="SEC16"></A>
       
   397 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   398 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC15"> &lt; </A>]</TD>
       
   399 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC17"> &gt; </A>]</TD>
       
   400 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   401 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   402 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   403 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   404 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   405 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   406 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   407 </TR></TABLE>
       
   408 <H3> 2.5.6 Upgrading from version 0.90.2 or earlier </H3>
       
   409 <!--docid::SEC16::-->
       
   410 <P>
       
   411 
       
   412 The name of the user to which mail to an unknown user is
       
   413 delivered changed from <SAMP>`*'</SAMP> to <SAMP>`+'</SAMP>. If you were using this
   116 feature, either change all your domains to accomodate this
   414 feature, either change all your domains to accomodate this
   117 change, or set the `default-username' config file to contain `*'.
   415 change, or set the <TT>`default-username'</TT> config file to contain <SAMP>`*'</SAMP>.
   118 <P>
   416 </P><P>
   119 <DT><B>0.88 or earlier</B><DD><P>The file format of the virtual password tables has changed from
   417 
       
   418 <HR SIZE="6">
       
   419 <A NAME="SEC17"></A>
       
   420 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   421 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC16"> &lt; </A>]</TD>
       
   422 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC18"> &gt; </A>]</TD>
       
   423 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   424 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   425 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   426 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   427 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   428 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   429 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   430 </TR></TABLE>
       
   431 <H3> 2.5.7 Upgrading from version 0.88 or earlier </H3>
       
   432 <!--docid::SEC17::-->
       
   433 <P>
       
   434 
       
   435 The file format of the virtual password tables has changed from
   120 plain text files to CDB tables. You will need to suspend local
   436 plain text files to CDB tables. You will need to suspend local
   121 deliveries before upgrading, and run the program `vpasswd2cdb' as
   437 deliveries before upgrading, and run the program <CODE>vpasswd2cdb</CODE> as
   122 each base user after upgrading, before re-enabling local
   438 each base user after upgrading, before re-enabling local
   123 deliveries.
   439 deliveries.
   124 </DL>
   440 </P><P>
   125 <H2>2.6 How do I configure qmail+patches to use vmailmgr for POP?</H2>
   441 
   126 
   442 <HR SIZE="6">
   127 <P>Put the string `<CODE>checkvpw</CODE>' into the file
   443 <A NAME="SEC18"></A>
   128 `<CODE>/etc/qmail/control/checkpassword</CODE>' and restart pop3d by
   444 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   129 typing `<CODE>/etc/rc.d/init.d/pop3d restart</CODE>'.
   445 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC17"> &lt; </A>]</TD>
   130 <H2>2.7 How do I allow clients to relay SMTP through me?</H2>
   446 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC19"> &gt; </A>]</TD>
   131 
   447 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
   132 <P>Download and install relay-ctrl from 
   448 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
   133 <A HREF="http://em.ca/~bruceg/relay-ctrl/">http://em.ca/~bruceg/relay-ctrl/</A>.
   449 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   450 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   451 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   452 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   453 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   454 </TR></TABLE>
       
   455 <H2> 2.6 How do I configure qmail+patches to use vmailmgr for POP? </H2>
       
   456 <!--docid::SEC18::-->
       
   457 <P>
       
   458 
       
   459 Put the string <KBD>checkvpw</KBD> into the file
       
   460 <TT>`/etc/qmail/control/checkpassword'</TT> and restart <CODE>qmail-pop3d</CODE> by
       
   461 typing <SAMP>`/etc/rc.d/init.d/pop3d restart'</SAMP>.
       
   462 </P><P>
       
   463 
       
   464 <HR SIZE="6">
       
   465 <A NAME="SEC19"></A>
       
   466 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   467 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC18"> &lt; </A>]</TD>
       
   468 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC20"> &gt; </A>]</TD>
       
   469 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   470 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   471 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   472 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   473 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   474 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   475 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   476 </TR></TABLE>
       
   477 <H2> 2.7 How do I allow clients to relay SMTP through me? </H2>
       
   478 <!--docid::SEC19::-->
       
   479 <P>
       
   480 
       
   481 Download and install relay-ctrl from
       
   482 <A HREF="http://untroubled.org/relay-ctrl/">http://untroubled.org/relay-ctrl/</A>.
   134 It works with vmailmgr, for both POP3 and IMAP clients.
   483 It works with vmailmgr, for both POP3 and IMAP clients.
   135 <H2><A NAME="s3">3. Usage</A></H2>
   484 </P><P>
   136 
   485 
   137 <H2>3.1 I can only use one IP address. How do I log in as a virtual user?</H2>
   486 <HR SIZE="6">
   138 
   487 <A NAME="SEC20"></A>
   139 <P>There are two ways to log in without using multiple IP addresses.
   488 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   140 <P>The first way is to log in as `userSEPvirtual.domain.org', where
   489 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC19"> &lt; </A>]</TD>
   141 `user' is the mailbox name of the virtual user, SEP is one of `@' or
   490 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC21"> &gt; </A>]</TD>
   142 `:' (by default, this is configurable in the
   491 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
   143 `<CODE>/etc/vmailmgr/</CODE>' directory), and
   492 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
   144 `<CODE>virtual.domain.org</CODE>' is the virtual domain's name, as
   493 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   145 listed in `<CODE>/var/qmail/control/virtualdomains</CODE>'.
   494 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
   146 <P>The second way is to use the internal form of the mailbox name --
   495 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
   147 that is, `<CODE>baseuser-user</CODE>', where `<CODE>user</CODE>' is the same
   496 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   148 as above, and `<CODE>baseuser</CODE>' is the username of the managing
   497 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   498 </TR></TABLE>
       
   499 <H1> 3. Usage </H1>
       
   500 <!--docid::SEC20::-->
       
   501 <P>
       
   502 
       
   503 <HR SIZE="6">
       
   504 <A NAME="SEC21"></A>
       
   505 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   506 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC20"> &lt; </A>]</TD>
       
   507 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC22"> &gt; </A>]</TD>
       
   508 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   509 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   510 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   511 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   512 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   513 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   514 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   515 </TR></TABLE>
       
   516 <H2> 3.1 I can only use one IP address. How do I log in as a virtual user? </H2>
       
   517 <!--docid::SEC21::-->
       
   518 <P>
       
   519 
       
   520 There are two ways to log in without using multiple IP addresses.
       
   521 </P><P>
       
   522 
       
   523 <UL>
       
   524 <LI>
       
   525 The first way is to log in as <SAMP>`user<VAR>SEP</VAR>virtual.domain.org'</SAMP>, where 
       
   526 <SAMP>`user'</SAMP> is the mailbox name of the virtual user, <VAR>SEP</VAR> is one of 
       
   527 <SAMP>`@'</SAMP> or <SAMP>`:'</SAMP> (by default, this is configurable in the 
       
   528 <TT>`/etc/vmailmgr/'</TT> directory), and <SAMP>`virtual.domain.org'</SAMP> is the virtual 
       
   529 domain's name, as listed in <TT>`/var/qmail/control/virtualdomains'</TT>.
       
   530 <P>
       
   531 
       
   532 <LI>
       
   533 The second way is to use the internal form of the mailbox name --
       
   534 that is, <SAMP>`baseuser-user'</SAMP>, where <SAMP>`user'</SAMP> is the same
       
   535 as above, and <SAMP>`baseuser'</SAMP> is the username of the managing
   149 user.
   536 user.
   150 <P>Example: `<CODE>/var/qmail/control/virtualdomains</CODE>' contains 
   537 <P>
   151 <PRE>
   538 
   152   testdomain.org:testuser
   539 For example, <TT>`/var/qmail/control/virtualdomains'</TT> contains 
   153 </PRE>
   540 <SAMP>`testdomain.org:testuser'</SAMP>, user <SAMP>`testuser'</SAMP> exists,
   154 
   541 and has set up a virtual mailbox with the name <SAMP>`v'</SAMP>.
   155 User `<CODE>testuser</CODE>' exists, and has set up a virtual mailbox
   542 The <VAR>separators</VAR> variable in <TT>`/etc/vmailmgr/'</TT>
   156 with the name `<CODE>v</CODE>'. The `<CODE>separators</CODE>' variable in
   543 contains <SAMP>`@:'</SAMP>.  This virtual user
   157 `<CODE>/etc/vmailmgr/</CODE>' contains `<CODE>@:</CODE>'. This virtual user
   544 could log in as <SAMP>`v@testdomain.org'</SAMP>,
   158 could log in as `<CODE>v@testdomain.org</CODE>',
   545 <SAMP>`v:testdomain.org'</SAMP>, or <SAMP>`testuser-v'</SAMP>.
   159 `<CODE>v:testdomain.org</CODE>', or `<CODE>testuser-v</CODE>'.
   546 </UL>
   160 <P>
   547 <P>
   161 <P>
   548 
   162 <H2>3.2 How do I get all misdirected mail sent to me?</H2>
   549 <HR SIZE="6">
   163 
   550 <A NAME="SEC22"></A>
   164 <P>In the `<CODE>vmailmgr/</CODE>' configuration directory, there is an
   551 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   165 entry called `<CODE>default-username</CODE>'. If mail to a virtual
   552 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC21"> &lt; </A>]</TD>
       
   553 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC23"> &gt; </A>]</TD>
       
   554 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   555 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   556 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   557 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   558 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   559 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   560 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   561 </TR></TABLE>
       
   562 <H2> 3.2 How do I get all misdirected mail sent to me? </H2>
       
   563 <!--docid::SEC22::-->
       
   564 <P>
       
   565 
       
   566 In the <TT>`vmailmgr/'</TT> configuration directory, there is an
       
   567 entry called <TT>`default-username'</TT>. If mail to a virtual
   166 domain does not match any users or aliases in that domain, it is
   568 domain does not match any users or aliases in that domain, it is
   167 delivered to the name listed in this configuration item if it exists
   569 delivered to the name listed in this configuration item if it exists
   168 (which defaults to `<CODE>+</CODE>'). To make this deliver to you,
   570 (which defaults to <SAMP>`+'</SAMP>). To make this deliver to you,
   169 simply type:
   571 simply type:
   170 <PRE>
   572 </P><P>
   171   vaddalias + me
   573 
   172 </PRE>
   574 <TABLE><tr><td>&nbsp;</td><td class=example><pre>vaddalias + me
   173 <H2><A NAME="s4">4. Troubleshooting</A></H2>
   575 </pre></td></tr></table></P><P>
   174 
   576 
   175 <H2>4.1 Bind error message from vmailmgrd.</H2>
   577 <HR SIZE="6">
   176 
   578 <A NAME="SEC23"></A>
   177 <P>If vmailmgrd reports `<CODE>vmailmgrd: bind: no such file or
   579 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   178 directory</CODE>' when you start it up, it means that can't create its
   580 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC22"> &lt; </A>]</TD>
   179 socket file.  By default, it will try to create the socket file
   581 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC24"> &gt; </A>]</TD>
   180 `<CODE>/tmp/.vmailmgrd</CODE>'. You must ensure that `<CODE>/tmp</CODE>' is
   582 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
   181 writable, or that the socket is created in some other place by
   583 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
   182 setting `<CODE>socket-file</CODE>' in the configuration.
   584 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   183 <H2>4.2 Error sending to an alias: qmail-queue exited with an error!</H2>
   585 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
   184 
   586 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
   185 <P>If qmail reports "deferral: vdeliver: qmail-queue exited with an
   587 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   186 error!", check where your qmail is installed.  On Debian systems,
   588 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
   187 you will need to type "<CODE>ls -s /usr/sbin /var/qmail/bin</CODE>",
   589 </TR></TABLE>
   188 since they've installed the qmail binaries into /usr/sbin.
   590 <H2> 3.3 How can I put system accounts in a virtual domain? </H2>
   189 <H2>4.3 Running vmailmgrd fails.</H2>
   591 <!--docid::SEC23::-->
   190 
   592 <P>
   191 <P>When run by itself, vmailmgrd will report "<CODE>Timed out waiting for
   593 
   192 remote</CODE>".  vmailmgrd needs to be run from unixserver, part of
   594 System accounts are those listed in <TT>`/etc/password'</TT> (or 
   193 the ucspi-unix package available at 
   595 <TT>`/var/qmail/users/cdb'</TT>). 
   194 <A HREF="http://em.ca/~bruceg/ucspi-unix/">http://em.ca/~bruceg/ucspi-unix/</A>.
   596 The system accounts are accessable, either though SMTP or POP3 or IMAP, as 
   195 <H2>4.4 POP3 or IMAP logins take 30 seconds or longer.</H2>
   597 <SAMP>`name@<VAR>DOMAIN</VAR>'</SAMP>, where <VAR>DOMAIN</VAR> is listed in
   196 
   598 <TT>`/var/qmail/control/locals'</TT>.
   197 <P>This is almost certainly a DNS lookup problem.  Make sure that DNS
   599 </P><P>
       
   600 
       
   601 Virtual accounts exist only as an artifact of vmailmgr management.
       
   602 They are accessable as <SAMP>`name@<VAR>DOMAIN</VAR>'</SAMP>, where <VAR>DOMAIN</VAR> is listed 
       
   603 in <TT>`/var/qmail/control/virtualdomains'</TT>.
       
   604 </P><P>
       
   605 
       
   606 You <STRONG>cannot</STRONG> mix accounts within a domain between system and virtual 
       
   607 domains.  If the domain is in <TT>`control/locals'</TT>, all accounts for that 
       
   608 domain must be system accounts.  If it is in <TT>`control/virtualdomains'</TT>, all 
       
   609 accounts for that domain must be virtual accounts.  Also, <TT>`control/locals'</TT> 
       
   610 overrides <TT>`control/virtualdomains'</TT>: if the domain is in <TT>`locals'</TT>, 
       
   611 <TT>`virtualdomains'</TT> is ignored.
       
   612 </P><P>
       
   613 
       
   614 As an aside, if the domain is neither in <TT>`locals'</TT> nor in
       
   615 <TT>`virtualdomains'</TT>, qmail will reject incoming messages, and vmailmgr will
       
   616 treat it as local.
       
   617 </P><P>
       
   618 
       
   619 <HR SIZE="6">
       
   620 <A NAME="SEC24"></A>
       
   621 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   622 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC23"> &lt; </A>]</TD>
       
   623 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC25"> &gt; </A>]</TD>
       
   624 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   625 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   626 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   627 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   628 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   629 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   630 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   631 </TR></TABLE>
       
   632 <H1> 4. Troubleshooting </H1>
       
   633 <!--docid::SEC24::-->
       
   634 <P>
       
   635 
       
   636 <HR SIZE="6">
       
   637 <A NAME="SEC25"></A>
       
   638 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   639 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC24"> &lt; </A>]</TD>
       
   640 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC26"> &gt; </A>]</TD>
       
   641 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   642 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   643 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   644 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   645 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   646 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   647 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   648 </TR></TABLE>
       
   649 <H2> 4.1 Bind error message from <CODE>vmailmgrd</CODE>. </H2>
       
   650 <!--docid::SEC25::-->
       
   651 <P>
       
   652 
       
   653 If <CODE>vmailmgrd</CODE> reports 
       
   654 <BLOCKQUOTE>
       
   655 vmailmgrd: bind: no such file or directory
       
   656 </BLOCKQUOTE>
       
   657 when you start it up, it means that can't create its socket file.  By default, 
       
   658 it will try to create the socket file <TT>`/tmp/.vmailmgrd'</TT>. You must ensure 
       
   659 that <TT>`/tmp/'</TT> is writable, or that the socket is created in some other place 
       
   660 by setting <VAR>socket-file</VAR> in the configuration.
       
   661 <P>
       
   662 
       
   663 <HR SIZE="6">
       
   664 <A NAME="SEC26"></A>
       
   665 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   666 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC25"> &lt; </A>]</TD>
       
   667 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC27"> &gt; </A>]</TD>
       
   668 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   669 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   670 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   671 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   672 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   673 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   674 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   675 </TR></TABLE>
       
   676 <H2> 4.2 Error sending to an alias: <CODE>qmail-queue</CODE> exited with an error! </H2>
       
   677 <!--docid::SEC26::-->
       
   678 <P>
       
   679 
       
   680 If qmail reports
       
   681 <BLOCKQUOTE>
       
   682 deferral: vdeliver: qmail-queue exited with an error!
       
   683 </BLOCKQUOTE>
       
   684 check where your qmail is installed.  On Debian systems,
       
   685 you will need to type <SAMP>`ls -s /usr/sbin /var/qmail/bin'</SAMP>,
       
   686 since they've installed the qmail binaries into <TT>`/usr/sbin'</TT>.
       
   687 <P>
       
   688 
       
   689 <HR SIZE="6">
       
   690 <A NAME="SEC27"></A>
       
   691 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   692 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC26"> &lt; </A>]</TD>
       
   693 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC28"> &gt; </A>]</TD>
       
   694 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   695 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   696 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   697 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   698 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   699 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   700 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   701 </TR></TABLE>
       
   702 <H2> 4.3 Running <CODE>vmailmgrd</CODE> fails. </H2>
       
   703 <!--docid::SEC27::-->
       
   704 <P>
       
   705 
       
   706 When run by itself, <CODE>vmailmgrd</CODE> will report
       
   707 <BLOCKQUOTE>
       
   708 Timed out waiting for remote
       
   709 </BLOCKQUOTE>
       
   710 <CODE>vmailmgrd</CODE> needs to be run from <CODE>unixserver</CODE>, part of the ucspi-unix
       
   711 package available at
       
   712 <A HREF="http://untroubled.org/ucspi-unix/">http://untroubled.org/ucspi-unix/</A>.
       
   713 <P>
       
   714 
       
   715 <HR SIZE="6">
       
   716 <A NAME="SEC28"></A>
       
   717 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   718 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC27"> &lt; </A>]</TD>
       
   719 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC29"> &gt; </A>]</TD>
       
   720 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   721 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   722 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   723 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   724 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   725 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   726 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   727 </TR></TABLE>
       
   728 <H2> 4.4 POP3 or IMAP logins take 30 seconds or longer. </H2>
       
   729 <!--docid::SEC28::-->
       
   730 <P>
       
   731 
       
   732 This is almost certainly a DNS lookup problem.  Make sure that DNS
   198 lookups aren't timing out, that lookups on all your IP addresses
   733 lookups aren't timing out, that lookups on all your IP addresses
   199 aren't failing, and that you can lookup remote addresses as well.
   734 aren't failing, and that you can lookup remote addresses as well.
   200 <P>If you are using 'tcpserver' for the head end to qmail-pop3d, then you
   735 </P><P>
   201 may want to the following 2 switches to the command line: <CODE>-R</CODE>
   736 
   202 and <CODE>-H</CODE>.  The former prevents tcpserver from attempting to
   737 If you are using <CODE>tcpserver</CODE> for the head end to <CODE>qmail-pop3d</CODE>, then 
   203 obtain TCPREMOTEINFO from the remote host.  This eliminates an "ident"
   738 you may want to add the following 2 switches to the command line: <SAMP>`-R'</SAMP> and 
   204 lookup that may be being blocked or silently dropped by a firewall.
   739 <SAMP>`-H'</SAMP>.  The former prevents <CODE>tcpserver</CODE> from attempting to obtain 
   205 The latter prevents tcpserver from doing a DNS lookup on the remote
   740 <VAR>TCPREMOTEINFO</VAR> from the remote host.  This eliminates an <CODE>ident</CODE> 
   206 IP.
   741 lookup that may be being blocked or silently dropped by a firewall. The latter 
   207 <H2><A NAME="s5">5. Miscellaneous</A></H2>
   742 prevents <CODE>tcpserver</CODE> from doing a DNS lookup on the remote IP.
   208 
   743 </P><P>
   209 <H2>5.1 How do I get in contact with other users?</H2>
   744 
   210 
   745 <HR SIZE="6">
   211 <P>There is a mailing list run by the author. To subscribe, send an
   746 <A NAME="SEC29"></A>
   212 e-mail (content and subject line is ignored) to 
   747 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   213 <A HREF="mailto:vmailmgr-subscribe@lists.em.ca">mailto:vmailmgr-subscribe@lists.em.ca</A>.
   748 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC28"> &lt; </A>]</TD>
   214 <P>Remember that if you have a problem that you want us to diagnose, we
   749 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC30"> &gt; </A>]</TD>
       
   750 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   751 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   752 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   753 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   754 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   755 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   756 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   757 </TR></TABLE>
       
   758 <H1> 5. Miscellaneous </H1>
       
   759 <!--docid::SEC29::-->
       
   760 <P>
       
   761 
       
   762 <HR SIZE="6">
       
   763 <A NAME="SEC30"></A>
       
   764 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   765 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC29"> &lt; </A>]</TD>
       
   766 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC31"> &gt; </A>]</TD>
       
   767 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   768 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   769 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   770 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   771 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   772 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   773 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   774 </TR></TABLE>
       
   775 <H2> 5.1 How do I get in contact with other users? </H2>
       
   776 <!--docid::SEC30::-->
       
   777 <P>
       
   778 
       
   779 There is a mailing list run by the author. To subscribe, send an
       
   780 e-mail (content and subject line is ignored) to
       
   781 <A HREF="mailto:vmailmgr-subscribe@lists.untroubled.org">vmailmgr-subscribe@lists.untroubled.org</A>.
       
   782 </P><P>
       
   783 
       
   784 Remember that if you have a problem that you want us to diagnose, we
   215 need to know the following important details:
   785 need to know the following important details:
   216 <OL>
   786 <OL>
   217 <LI>The output of `<CODE>qmail-showctl</CODE>` </LI>
   787 <LI>
   218 <LI>The contents of the vmailmgrd log for the attempt you are
   788 The output of <CODE>qmail-showctl</CODE>
   219 trying to diagnose</LI>
   789 <LI>
   220 <LI>The contents of the qmail and smtpd logs for a failed delivery
   790 The contents of the <CODE>vmailmgrd</CODE> log for the attempt you are
   221 attempt</LI>
   791 trying to diagnose
   222 <LI>The contents of the pop3d logs for a failed login attempt</LI>
   792 <LI>
   223 <LI>The complete command line with which vmailmgrd and qmail-pop3d
   793 The contents of the qmail and smtpd logs for a failed delivery
   224 was invoked</LI>
   794 attempt
       
   795 <LI>
       
   796 The contents of the pop3d logs for a failed login attempt
       
   797 <LI>
       
   798 The complete command line with which <CODE>vmailmgrd</CODE> and <CODE>qmail-pop3d</CODE>
       
   799 was invoked
   225 </OL>
   800 </OL>
       
   801 <P>
   226 
   802 
   227 Please do not contact the author directly with vmailmgr questions. 
   803 Please do not contact the author directly with vmailmgr questions. 
   228 <H2>5.2 Are development version of vmailmgr available anywhere?</H2>
   804 </P><P>
   229 
   805 
   230 <P>Yes, they are available through anonymous CVS.
   806 <HR SIZE="6">
       
   807 <A NAME="SEC31"></A>
       
   808 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   809 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC30"> &lt; </A>]</TD>
       
   810 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC32"> &gt; </A>]</TD>
       
   811 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   812 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   813 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   814 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   815 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   816 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   817 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   818 </TR></TABLE>
       
   819 <H2> 5.2 Are development version of vmailmgr available anywhere? </H2>
       
   820 <!--docid::SEC31::-->
       
   821 <P>
       
   822 
       
   823 Yes, they are available through anonymous CVS.
   231 To access the CVS server, set your <CODE>CVSROOT</CODE> to
   824 To access the CVS server, set your <CODE>CVSROOT</CODE> to
   232 <CODE>:pserver:cvs@bruce-guenter.dyndns.org:/CVS</CODE>, log in with an
   825 <KBD>:pserver:cvs@bruce-guenter.dyndns.org:/CVS</KBD>, log in with an
   233 empty password, and check out the <CODE>vmailmgr</CODE> module.
   826 empty password, and check out the <CODE>vmailmgr</CODE> module.
   234 <H2>5.3 How does incoming email get handled?</H2>
   827 </P><P>
   235 
   828 
   236 <P>Incoming email is first received by the qmail SMTP daemon and
   829 <HR SIZE="6">
   237 inserted into the qmail queue. Then `<CODE>qmail-send</CODE>' examines
   830 <A NAME="SEC32"></A>
       
   831 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   832 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC31"> &lt; </A>]</TD>
       
   833 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC33"> &gt; </A>]</TD>
       
   834 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   835 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   836 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   837 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   838 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   839 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   840 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   841 </TR></TABLE>
       
   842 <H2> 5.3 How does incoming email get handled? </H2>
       
   843 <!--docid::SEC32::-->
       
   844 <P>
       
   845 
       
   846 Incoming email is first received by the qmail SMTP daemon and
       
   847 inserted into the qmail queue. Then <CODE>qmail-send</CODE> examines
   238 the email envelope (which details the recipient address or
   848 the email envelope (which details the recipient address or
   239 addresses) to determine how to dispatch the message. It looks up the
   849 addresses) to determine how to dispatch the message. It looks up the
   240 domain name of each recipient in
   850 domain name of each recipient in
   241 `<CODE>/var/qmail/control/virtualdomains</CODE>', and prefixes the user
   851 <TT>`/var/qmail/control/virtualdomains'</TT>, and prefixes the user
   242 name with the string that it finds. It then looks up the resulting
   852 name with the string that it finds. It then looks up the resulting
   243 user name in the system password table (or in
   853 user name in the system password table (or in
   244 `<CODE>/var/qmail/users/cdb</CODE>' if it exists) to find the base user
   854 <TT>`/var/qmail/users/cdb'</TT> if it exists) to find the base user
   245 name and home directory (which I will call `<CODE>$HOME</CODE>'). It
   855 name and home directory (which I will call <CODE>$HOME</CODE>). It
   246 then looks for the file `<CODE>$HOME/.qmail-VIRTUAL</CODE>'. If that's
   856 then looks for the file <TT>`<CODE>$HOME</CODE>/.qmail-VIRTUAL'</TT>. If that's
   247 not found, it looks for the file `<CODE>$HOME/.qmail-default</CODE>',
   857 not found, it looks for the file <TT>`<CODE>$HOME</CODE>/.qmail-default'</TT>,
   248 which will contain an instruction to pipe the message to
   858 which will contain an instruction to pipe the message to
   249 `<CODE>vdeliver</CODE>'.
   859 <CODE>vdeliver</CODE>.
   250 <P>This is where vmailmgr first enters the picture. The virtual user
   860 </P><P>
   251 name is sent to `vdeliver' through environment variables. It looks
   861 
   252 in the configuration files (in `<CODE>$HOME/.vmailmgr</CODE>' and then
   862 This is where vmailmgr first enters the picture. The virtual user
   253 in `<CODE>/etc/vmailmgr</CODE>') to determine the location of the
   863 name is sent to <CODE>vdeliver</CODE> through environment variables. It looks
       
   864 in the configuration files (in <TT>`<CODE>$HOME</CODE>/.vmailmgr'</TT> and then
       
   865 in <TT>`/etc/vmailmgr'</TT>) to determine the location of the
   254 password table, and looks up the virtual user name in the table to
   866 password table, and looks up the virtual user name in the table to
   255 determine delivery instructions. If the name is not found, the
   867 determine delivery instructions. If the name is not found, the
   256 message is bounced and delivery ends. Otherwise, it then looks for
   868 message is bounced and delivery ends. Otherwise, it then looks for
   257 the `<CODE>vdeliver-predeliver</CODE>' script in the configuration
   869 the <CODE>vdeliver-predeliver</CODE> script in the configuration
   258 directories (in reverse order) and executes any that are found. It
   870 directories (in reverse order) and executes any that are found. It
   259 then delivers the message to all the listed destinations -- an
   871 then delivers the message to all the listed destinations -- an
   260 optional mailbox directory and zero or more forwarding
   872 optional mailbox directory and zero or more forwarding
   261 addresses. Finally, it looks for the `<CODE>vdeliver-postdeliver</CODE>'
   873 addresses. Finally, it looks for the <CODE>vdeliver-postdeliver</CODE>
   262 script and executes any that are found.
   874 script and executes any that are found.
   263 <H2>5.4 How does outgoing email get handled?</H2>
   875 </P><P>
   264 
   876 
   265 <P>Outgoing email is not handled by vmailmgr. For details on outgoing
   877 <HR SIZE="6">
       
   878 <A NAME="SEC33"></A>
       
   879 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   880 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC32"> &lt; </A>]</TD>
       
   881 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC34"> &gt; </A>]</TD>
       
   882 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   883 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   884 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   885 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   886 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   887 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   888 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   889 </TR></TABLE>
       
   890 <H2> 5.4 How does outgoing email get handled? </H2>
       
   891 <!--docid::SEC33::-->
       
   892 <P>
       
   893 
       
   894 Outgoing email is not handled by vmailmgr. For details on outgoing
   266 email handling, check the qmail documentation.
   895 email handling, check the qmail documentation.
   267 <H2>5.5 What about security of CGI and PHP functions?</H2>
   896 </P><P>
   268 
   897 
   269 <P>The socket used by the daemon is a UNIX-domain socket (as opposed to
   898 <HR SIZE="6">
       
   899 <A NAME="SEC34"></A>
       
   900 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   901 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC33"> &lt; </A>]</TD>
       
   902 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC35"> &gt; </A>]</TD>
       
   903 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   904 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   905 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   906 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   907 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   908 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   909 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   910 </TR></TABLE>
       
   911 <H2> 5.5 What about security of CGI and PHP functions? </H2>
       
   912 <!--docid::SEC34::-->
       
   913 <P>
       
   914 
       
   915 The socket used by the daemon is a UNIX-domain socket (as opposed to
   270 Internet-domain), meaning you need local access on the computer to
   916 Internet-domain), meaning you need local access on the computer to
   271 open up a connection.  The path for this socket is run-time
   917 open up a connection.  The path for this socket is run-time
   272 configurable.
   918 configurable.
   273 <P>The daemon forks a new connection for each connection, up to a
   919 </P><P>
       
   920 
       
   921 The daemon forks a new connection for each connection, up to a
   274 configurable maximum (at which point it stops listening, IIRC, I
   922 configurable maximum (at which point it stops listening, IIRC, I
   275 should verify this).  The idea of threading has been completely
   923 should verify this).  The idea of threading has been completely
   276 discarded to avoid a bug in a command creeping in and makeing the
   924 discarded to avoid a bug in a command creeping in and making the
   277 whole server break.
   925 whole server break.
   278 <P>The protocol spoken over the socket is explicitly bounded to at most
   926 </P><P>
       
   927 
       
   928 The protocol spoken over the socket is explicitly bounded to at most
   279 64kB of data, and all data is prefixed by a size.  Static-sized
   929 64kB of data, and all data is prefixed by a size.  Static-sized
   280 buffers are only used with static-sized reads, and therefore can't be
   930 buffers are only used with static-sized reads, and therefore can't be
   281 overflowed with stack-smashing tricks.
   931 overflowed with stack-smashing tricks.
   282 <P>The daemon commands setuid to the appropriate user as soon as the base
   932 </P><P>
       
   933 
       
   934 The daemon commands setuid to the appropriate user as soon as the base
   283 user has been verified, to avoid doing any more than necessary as
   935 user has been verified, to avoid doing any more than necessary as
   284 root, as well as to avoid the possibility of tricking the daemon into
   936 root, as well as to avoid the possibility of tricking the daemon into
   285 reading a file another user wouldn't normally have access to.
   937 reading a file another user wouldn't normally have access to.
   286 <P>To help avoid DoS on the local computer, a 1-second alarm is set as
   938 </P><P>
       
   939 
       
   940 To help avoid DoS on the local computer, a 1-second alarm is set as
   287 soon as the connection is received, and is only cleared once all the
   941 soon as the connection is received, and is only cleared once all the
   288 data has been read.  If it takes longer than 1 second to read the data
   942 data has been read.  If it takes longer than 1 second to read the data
   289 from the socket, the server process exits.
   943 from the socket, the server process exits.
   290 <H2>5.6 What are the differences between vmailmgr and vpopmail?</H2>
   944 </P><P>
   291 
   945 
   292 <P>The primary difference between vmailmgr and vpopmail is the use of
   946 <HR SIZE="6">
       
   947 <A NAME="SEC35"></A>
       
   948 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   949 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC34"> &lt; </A>]</TD>
       
   950 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
       
   951 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
       
   952 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1"> Up </A>]</TD>
       
   953 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   954 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   955 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   956 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   957 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   958 </TR></TABLE>
       
   959 <H2> 5.6 What are the differences between vmailmgr and vpopmail? </H2>
       
   960 <!--docid::SEC35::-->
       
   961 <P>
       
   962 
       
   963 The primary difference between vmailmgr and vpopmail is the use of
   293 base users.  With vmailmgr there is one base user for each virtual
   964 base users.  With vmailmgr there is one base user for each virtual
   294 domain.  With vpopmail, there is one base user for the entire
   965 domain.  With vpopmail, there is one base user for the entire
   295 virtual domain system.
   966 virtual domain system.
       
   967 </P><P>
       
   968 
       
   969 <HR SIZE="6">
       
   970 <A NAME="SEC_Contents"></A>
       
   971 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   972 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
   973 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
   974 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   975 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
   976 </TR></TABLE>
       
   977 <H1>Table of Contents</H1>
       
   978 <UL>
       
   979 <A NAME="TOC1" HREF="FAQ.html#SEC1">1. Building and Installing</A>
       
   980 <BR>
       
   981 <UL>
       
   982 <A NAME="TOC2" HREF="FAQ.html#SEC2">1.1 What compiler and libraries do I need to build vmailmgr?</A>
       
   983 <BR>
       
   984 <A NAME="TOC3" HREF="FAQ.html#SEC3">1.2 Does vmailmgr work with shadow passwords?</A>
       
   985 <BR>
       
   986 <A NAME="TOC4" HREF="FAQ.html#SEC4">1.3 Does vmailmgr support IMAP?</A>
       
   987 <BR>
       
   988 </UL>
       
   989 <A NAME="TOC5" HREF="FAQ.html#SEC5">2. Setup and Configuration</A>
       
   990 <BR>
       
   991 <UL>
       
   992 <A NAME="TOC6" HREF="FAQ.html#SEC6">2.1 What other software is needed to run vmailmgr?</A>
       
   993 <BR>
       
   994 <A NAME="TOC7" HREF="FAQ.html#SEC7">2.2 How do I record the output of vmailmgrd with syslog?</A>
       
   995 <BR>
       
   996 <A NAME="TOC8" HREF="FAQ.html#SEC8">2.3 How do I record the output of vmailmgrd with multilog?</A>
       
   997 <BR>
       
   998 <A NAME="TOC9" HREF="FAQ.html#SEC9">2.4 How do I setup VMmailMgr IMAP support?</A>
       
   999 <BR>
       
  1000 <A NAME="TOC10" HREF="FAQ.html#SEC10">2.5 Upgrading from Previous Versions</A>
       
  1001 <BR>
       
  1002 <UL>
       
  1003 <A NAME="TOC11" HREF="FAQ.html#SEC11">2.5.1 Upgrading from version 0.96.6 or earlier</A>
       
  1004 <BR>
       
  1005 <A NAME="TOC12" HREF="FAQ.html#SEC12">2.5.2 Upgrading from version 0.96.2 or earlier</A>
       
  1006 <BR>
       
  1007 <A NAME="TOC13" HREF="FAQ.html#SEC13">2.5.3 Upgrading from version 0.94 or earlier, using the POP bulletin facility</A>
       
  1008 <BR>
       
  1009 <A NAME="TOC14" HREF="FAQ.html#SEC14">2.5.4 Upgrading from version 0.93 or earlier</A>
       
  1010 <BR>
       
  1011 <A NAME="TOC15" HREF="FAQ.html#SEC15">2.5.5 Upgrading from version 0.92.2 or earlier</A>
       
  1012 <BR>
       
  1013 <A NAME="TOC16" HREF="FAQ.html#SEC16">2.5.6 Upgrading from version 0.90.2 or earlier</A>
       
  1014 <BR>
       
  1015 <A NAME="TOC17" HREF="FAQ.html#SEC17">2.5.7 Upgrading from version 0.88 or earlier</A>
       
  1016 <BR>
       
  1017 </UL>
       
  1018 <A NAME="TOC18" HREF="FAQ.html#SEC18">2.6 How do I configure qmail+patches to use vmailmgr for POP?</A>
       
  1019 <BR>
       
  1020 <A NAME="TOC19" HREF="FAQ.html#SEC19">2.7 How do I allow clients to relay SMTP through me?</A>
       
  1021 <BR>
       
  1022 </UL>
       
  1023 <A NAME="TOC20" HREF="FAQ.html#SEC20">3. Usage</A>
       
  1024 <BR>
       
  1025 <UL>
       
  1026 <A NAME="TOC21" HREF="FAQ.html#SEC21">3.1 I can only use one IP address. How do I log in as a virtual user?</A>
       
  1027 <BR>
       
  1028 <A NAME="TOC22" HREF="FAQ.html#SEC22">3.2 How do I get all misdirected mail sent to me?</A>
       
  1029 <BR>
       
  1030 <A NAME="TOC23" HREF="FAQ.html#SEC23">3.3 How can I put system accounts in a virtual domain?</A>
       
  1031 <BR>
       
  1032 </UL>
       
  1033 <A NAME="TOC24" HREF="FAQ.html#SEC24">4. Troubleshooting</A>
       
  1034 <BR>
       
  1035 <UL>
       
  1036 <A NAME="TOC25" HREF="FAQ.html#SEC25">4.1 Bind error message from <CODE>vmailmgrd</CODE>.</A>
       
  1037 <BR>
       
  1038 <A NAME="TOC26" HREF="FAQ.html#SEC26">4.2 Error sending to an alias: <CODE>qmail-queue</CODE> exited with an error!</A>
       
  1039 <BR>
       
  1040 <A NAME="TOC27" HREF="FAQ.html#SEC27">4.3 Running <CODE>vmailmgrd</CODE> fails.</A>
       
  1041 <BR>
       
  1042 <A NAME="TOC28" HREF="FAQ.html#SEC28">4.4 POP3 or IMAP logins take 30 seconds or longer.</A>
       
  1043 <BR>
       
  1044 </UL>
       
  1045 <A NAME="TOC29" HREF="FAQ.html#SEC29">5. Miscellaneous</A>
       
  1046 <BR>
       
  1047 <UL>
       
  1048 <A NAME="TOC30" HREF="FAQ.html#SEC30">5.1 How do I get in contact with other users?</A>
       
  1049 <BR>
       
  1050 <A NAME="TOC31" HREF="FAQ.html#SEC31">5.2 Are development version of vmailmgr available anywhere?</A>
       
  1051 <BR>
       
  1052 <A NAME="TOC32" HREF="FAQ.html#SEC32">5.3 How does incoming email get handled?</A>
       
  1053 <BR>
       
  1054 <A NAME="TOC33" HREF="FAQ.html#SEC33">5.4 How does outgoing email get handled?</A>
       
  1055 <BR>
       
  1056 <A NAME="TOC34" HREF="FAQ.html#SEC34">5.5 What about security of CGI and PHP functions?</A>
       
  1057 <BR>
       
  1058 <A NAME="TOC35" HREF="FAQ.html#SEC35">5.6 What are the differences between vmailmgr and vpopmail?</A>
       
  1059 <BR>
       
  1060 </UL>
       
  1061 </UL>
       
  1062 <HR SIZE=1>
       
  1063 <A NAME="SEC_OVERVIEW"></A>
       
  1064 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
  1065 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
  1066 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
  1067 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1068 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
  1069 </TR></TABLE>
       
  1070 <H1>Short Table of Contents</H1>
       
  1071 <BLOCKQUOTE>
       
  1072 <A NAME="TOC1" HREF="FAQ.html#SEC1">1. Building and Installing</A>
       
  1073 <BR>
       
  1074 <A NAME="TOC5" HREF="FAQ.html#SEC5">2. Setup and Configuration</A>
       
  1075 <BR>
       
  1076 <A NAME="TOC20" HREF="FAQ.html#SEC20">3. Usage</A>
       
  1077 <BR>
       
  1078 <A NAME="TOC24" HREF="FAQ.html#SEC24">4. Troubleshooting</A>
       
  1079 <BR>
       
  1080 <A NAME="TOC29" HREF="FAQ.html#SEC29">5. Miscellaneous</A>
       
  1081 <BR>
       
  1082 
       
  1083 </BLOCKQUOTE>
       
  1084 <HR SIZE=1>
       
  1085 <A NAME="SEC_About"></A>
       
  1086 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
  1087 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC1">Top</A>]</TD>
       
  1088 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_Contents">Contents</A>]</TD>
       
  1089 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1090 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="FAQ.html#SEC_About"> ? </A>]</TD>
       
  1091 </TR></TABLE>
       
  1092 <H1>About this document</H1>
       
  1093 This document was generated by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
       
  1094 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
       
  1095 "><I>texi2html</I></A>
       
  1096 <P></P>  
       
  1097 The buttons in the navigation panels have the following meaning:
       
  1098 <P></P>
       
  1099 <table border = "1">
       
  1100 <TR>
       
  1101 <TH> Button </TH>
       
  1102 <TH> Name </TH>
       
  1103 <TH> Go to </TH>
       
  1104 <TH> From 1.2.3 go to</TH>
       
  1105 </TR>
       
  1106 <TR>
       
  1107 <TD ALIGN="CENTER">
       
  1108  [ &lt; ] </TD>
       
  1109 <TD ALIGN="CENTER">
       
  1110 Back
       
  1111 </TD>
       
  1112 <TD>
       
  1113 previous section in reading order
       
  1114 </TD>
       
  1115 <TD>
       
  1116 1.2.2
       
  1117 </TD>
       
  1118 </TR>
       
  1119 <TR>
       
  1120 <TD ALIGN="CENTER">
       
  1121  [ &gt; ] </TD>
       
  1122 <TD ALIGN="CENTER">
       
  1123 Forward
       
  1124 </TD>
       
  1125 <TD>
       
  1126 next section in reading order
       
  1127 </TD>
       
  1128 <TD>
       
  1129 1.2.4
       
  1130 </TD>
       
  1131 </TR>
       
  1132 <TR>
       
  1133 <TD ALIGN="CENTER">
       
  1134  [ &lt;&lt; ] </TD>
       
  1135 <TD ALIGN="CENTER">
       
  1136 FastBack
       
  1137 </TD>
       
  1138 <TD>
       
  1139 previous or up-and-previous section 
       
  1140 </TD>
       
  1141 <TD>
       
  1142 1.1
       
  1143 </TD>
       
  1144 </TR>
       
  1145 <TR>
       
  1146 <TD ALIGN="CENTER">
       
  1147  [ Up ] </TD>
       
  1148 <TD ALIGN="CENTER">
       
  1149 Up
       
  1150 </TD>
       
  1151 <TD>
       
  1152 up section
       
  1153 </TD>
       
  1154 <TD>
       
  1155 1.2
       
  1156 </TD>
       
  1157 </TR>
       
  1158 <TR>
       
  1159 <TD ALIGN="CENTER">
       
  1160  [ &gt;&gt; ] </TD>
       
  1161 <TD ALIGN="CENTER">
       
  1162 FastForward
       
  1163 </TD>
       
  1164 <TD>
       
  1165 next or up-and-next section
       
  1166 </TD>
       
  1167 <TD>
       
  1168 1.3
       
  1169 </TD>
       
  1170 </TR>
       
  1171 <TR>
       
  1172 <TD ALIGN="CENTER">
       
  1173  [Top] </TD>
       
  1174 <TD ALIGN="CENTER">
       
  1175 Top
       
  1176 </TD>
       
  1177 <TD>
       
  1178 cover (top) of document
       
  1179 </TD>
       
  1180 <TD>
       
  1181  &nbsp; 
       
  1182 </TD>
       
  1183 </TR>
       
  1184 <TR>
       
  1185 <TD ALIGN="CENTER">
       
  1186  [Contents] </TD>
       
  1187 <TD ALIGN="CENTER">
       
  1188 Contents
       
  1189 </TD>
       
  1190 <TD>
       
  1191 table of contents
       
  1192 </TD>
       
  1193 <TD>
       
  1194  &nbsp; 
       
  1195 </TD>
       
  1196 </TR>
       
  1197 <TR>
       
  1198 <TD ALIGN="CENTER">
       
  1199  [Index] </TD>
       
  1200 <TD ALIGN="CENTER">
       
  1201 Index
       
  1202 </TD>
       
  1203 <TD>
       
  1204 concept index
       
  1205 </TD>
       
  1206 <TD>
       
  1207  &nbsp; 
       
  1208 </TD>
       
  1209 </TR>
       
  1210 <TR>
       
  1211 <TD ALIGN="CENTER">
       
  1212  [ ? ] </TD>
       
  1213 <TD ALIGN="CENTER">
       
  1214 About
       
  1215 </TD>
       
  1216 <TD>
       
  1217 this page
       
  1218 </TD>
       
  1219 <TD>
       
  1220  &nbsp; 
       
  1221 </TD>
       
  1222 </TR>
       
  1223 </TABLE>
       
  1224 <P></P>
       
  1225 where the <STRONG> Example </STRONG> assumes that the current position 
       
  1226 is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of 
       
  1227 the following structure:
       
  1228 <UL>
       
  1229 <LI> 1. Section One  </LI>
       
  1230 <UL>
       
  1231 <LI>1.1 Subsection One-One</LI>
       
  1232 <UL>
       
  1233 <LI> ... </LI>
       
  1234 </UL>
       
  1235 <LI>1.2 Subsection One-Two</LI>
       
  1236 <UL>
       
  1237 <LI>1.2.1 Subsubsection One-Two-One
       
  1238 </LI><LI>1.2.2 Subsubsection One-Two-Two
       
  1239 </LI><LI>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp; <STRONG>
       
  1240 &lt;== Current Position </STRONG>
       
  1241 </LI><LI>1.2.4 Subsubsection One-Two-Four
       
  1242 </LI></UL>
       
  1243 <LI>1.3 Subsection One-Three</LI>
       
  1244 <UL>
       
  1245 <LI> ... </LI>
       
  1246 </UL>
       
  1247 <LI>1.4 Subsection One-Four</LI>
       
  1248 </UL>
       
  1249 </UL>
       
  1250 
       
  1251 <HR SIZE=1>
       
  1252 <BR>  
       
  1253 <FONT SIZE="-1">
       
  1254 This document was generated
       
  1255 by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
       
  1256 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
       
  1257 "><I>texi2html</I></A>
       
  1258 
   296 </BODY>
  1259 </BODY>
   297 </HTML>
  1260 </HTML>