doc/configuration.html
changeset 2 b3afb9f1e801
parent 0 6f7a81934006
equal deleted inserted replaced
1:30113bfbe723 2:b3afb9f1e801
     1 <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 -->
     2 <HEAD>
    13 <HEAD>
     3 <!-- Created by texi2html 1.56k from configuration.texi on 14 September 2000 -->
    14 <TITLE>Vmailmgr Configuration Files: </TITLE>
     4 
    15 
     5 <TITLE>Vmailmgr Configuration Files</TITLE>
    16 <META NAME="description" CONTENT="Vmailmgr Configuration Files: ">
       
    17 <META NAME="keywords" CONTENT="Vmailmgr Configuration Files: ">
       
    18 <META NAME="resource-type" CONTENT="document">
       
    19 <META NAME="distribution" CONTENT="global">
       
    20 <META NAME="Generator" CONTENT="texi2html 1.64">
       
    21 
     6 </HEAD>
    22 </HEAD>
     7 <BODY>
    23 
     8 <H1>Vmailmgr Configuration Files</H1>
    24 <BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
     9 <H2>14 September 2000</H2>
    25 
    10 <ADDRESS>Bruce Guenter</ADDRESS>
    26 <A NAME="SEC_Top"></A>
    11 <P>
    27 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    12 <P><HR><P>
    28 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top">Top</A>]</TD>
    13 <H1>Table of Contents</H1>
    29 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
    14 <UL>
    30 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
    15 <LI><A NAME="TOC1" HREF="configuration.html#SEC1">1. General Information</A>
    31 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
    16 <UL>
    32 </TR></TABLE>
    17 <LI><A NAME="TOC2" HREF="configuration.html#SEC2">1.1 Search Order</A>
    33 <H1>Vmailmgr Configuration Files</H1></P><P>
    18 <LI><A NAME="TOC3" HREF="configuration.html#SEC3">1.2 File Types</A>
    34 
    19 <LI><A NAME="TOC4" HREF="configuration.html#SEC4">1.3 Command Execution</A>
    35 <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
    20 </UL>
    36 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC1">1. General Information</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
    21 <LI><A NAME="TOC5" HREF="configuration.html#SEC5">2. Configuration Files</A>
    37 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC5">2. Configuration Files</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
    22 <UL>
    38 </TABLE></BLOCKQUOTE>
    23 <LI><A NAME="TOC6" HREF="configuration.html#SEC6">2.1 authvmailmgr-error</A>
    39 <P>
    24 <LI><A NAME="TOC7" HREF="configuration.html#SEC7">2.2 authvmailmgr-loginfail</A>
    40 
    25 <LI><A NAME="TOC8" HREF="configuration.html#SEC8">2.3 authvmailmgr-postsetuid</A>
    41 <HR SIZE=1>
    26 <LI><A NAME="TOC9" HREF="configuration.html#SEC9">2.4 authvmailmgr-presetuid</A>
    42 <A NAME="SEC1"></A>
    27 <LI><A NAME="TOC10" HREF="configuration.html#SEC10">2.5 autoresponse-dir</A>
    43 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    28 <LI><A NAME="TOC11" HREF="configuration.html#SEC11">2.6 autoresponse-file</A>
    44 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top"> &lt; </A>]</TD>
    29 <LI><A NAME="TOC12" HREF="configuration.html#SEC12">2.7 bulletin-dir</A>
    45 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC2"> &gt; </A>]</TD>
    30 <LI><A NAME="TOC13" HREF="configuration.html#SEC13">2.8 checkvpw-error</A>
    46 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top"> &lt;&lt; </A>]</TD>
    31 <LI><A NAME="TOC14" HREF="configuration.html#SEC14">2.9 checkvpw-loginfail</A>
    47 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top"> Up </A>]</TD>
    32 <LI><A NAME="TOC15" HREF="configuration.html#SEC15">2.10 checkvpw-postexec</A>
    48 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &gt;&gt; </A>]</TD>
    33 <LI><A NAME="TOC16" HREF="configuration.html#SEC16">2.11 checkvpw-postsetuid</A>
    49 <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="configuration.html#SEC_Top">Top</A>]</TD>
    34 <LI><A NAME="TOC17" HREF="configuration.html#SEC17">2.12 checkvpw-presetuid</A>
    50 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
    35 <LI><A NAME="TOC18" HREF="configuration.html#SEC18">2.13 default-expiry</A>
    51 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
    36 <LI><A NAME="TOC19" HREF="configuration.html#SEC19">2.14 default-maildir</A>
    52 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
    37 <LI><A NAME="TOC20" HREF="configuration.html#SEC20">2.15 default-msgcount</A>
    53 </TR></TABLE>
    38 <LI><A NAME="TOC21" HREF="configuration.html#SEC21">2.16 default-msgsize</A>
    54 <A NAME="General Information"></A>
    39 <LI><A NAME="TOC22" HREF="configuration.html#SEC22">2.17 default-hardquota</A>
    55 <H1> 1. General Information </H1>
    40 <LI><A NAME="TOC23" HREF="configuration.html#SEC23">2.18 default-softquota</A>
    56 <!--docid::SEC1::-->
    41 <LI><A NAME="TOC24" HREF="configuration.html#SEC24">2.19 default-username</A>
    57 <P>
    42 <LI><A NAME="TOC25" HREF="configuration.html#SEC25">2.20 error-maildir</A>
    58 
    43 <LI><A NAME="TOC26" HREF="configuration.html#SEC26">2.21 global-bulletin-dir</A>
    59 <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
    44 <LI><A NAME="TOC27" HREF="configuration.html#SEC27">2.22 maildir-arg-str</A>
    60 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC2">1.1 Search Order</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
    45 <LI><A NAME="TOC28" HREF="configuration.html#SEC28">2.23 password-file</A>
    61 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC3">1.2 File Types</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
    46 <LI><A NAME="TOC29" HREF="configuration.html#SEC29">2.24 postmaster-aliases</A>
    62 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC4">1.3 Command Execution</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
    47 <LI><A NAME="TOC30" HREF="configuration.html#SEC30">2.25 postmaster-email</A>
    63 </TABLE></BLOCKQUOTE>
    48 <LI><A NAME="TOC31" HREF="configuration.html#SEC31">2.26 qmail-root</A>
    64 <P>
    49 <LI><A NAME="TOC32" HREF="configuration.html#SEC32">2.27 separators</A>
    65 
    50 <LI><A NAME="TOC33" HREF="configuration.html#SEC33">2.28 socket-file</A>
    66 <A NAME="Search Order"></A>
    51 <LI><A NAME="TOC34" HREF="configuration.html#SEC34">2.29 user-dir</A>
    67 <HR SIZE="6">
    52 <LI><A NAME="TOC35" HREF="configuration.html#SEC35">2.30 user-dir-bits</A>
    68 <A NAME="SEC2"></A>
    53 <LI><A NAME="TOC36" HREF="configuration.html#SEC36">2.31 user-dir-slices</A>
    69 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    54 <LI><A NAME="TOC37" HREF="configuration.html#SEC37">2.32 vdeliver-postdeliver</A>
    70 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> &lt; </A>]</TD>
    55 <LI><A NAME="TOC38" HREF="configuration.html#SEC38">2.33 vdeliver-predeliver</A>
    71 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC3"> &gt; </A>]</TD>
    56 <LI><A NAME="TOC39" HREF="configuration.html#SEC39">2.34 vsetup-pre</A>
    72 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> &lt;&lt; </A>]</TD>
    57 <LI><A NAME="TOC40" HREF="configuration.html#SEC40">2.35 vsetup-pre</A>
    73 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> Up </A>]</TD>
    58 </UL>
    74 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &gt;&gt; </A>]</TD>
    59 </UL>
    75 <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="configuration.html#SEC_Top">Top</A>]</TD>
    60 <P><HR><P>
    76 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
    61 
    77 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
    62 
    78 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
    63 <H1><A NAME="SEC1" HREF="configuration.html#TOC1">1. General Information</A></H1>
    79 </TR></TABLE>
    64 
    80 <H2> 1.1 Search Order </H2>
    65 
    81 <!--docid::SEC2::-->
    66 
    82 <P>
    67 <H2><A NAME="SEC2" HREF="configuration.html#TOC2">1.1 Search Order</A></H2>
    83 
    68 
       
    69 <P>
       
    70 The system will look for the configuration files listed below in one of
    84 The system will look for the configuration files listed below in one of
    71 the following three locations, in the order they are listed:
    85 the following three locations, in the order they are listed:
    72 
       
    73 <OL>
    86 <OL>
    74 <LI>The domain-local configuration directory
    87 <LI>The domain-local configuration directory
    75 
       
    76 <LI>The user-local configuration directory
    88 <LI>The user-local configuration directory
    77 
       
    78 <LI>The global configuration directory
    89 <LI>The global configuration directory
    79 
       
    80 </OL>
    90 </OL>
    81 
       
    82 <P>
       
    83 The global configuration directory is set to <TT>`/etc/vmailmgr'</TT> by
    91 The global configuration directory is set to <TT>`/etc/vmailmgr'</TT> by
    84 default.
    92 default.
    85 The user-local and domain-local configuration directories (for now, one
    93 The user-local and domain-local configuration directories (for now, one
    86 and the same) are a subdirectory, named <TT>`.vmailmgr'</TT> by default, of
    94 and the same) are a subdirectory, named <TT>`.vmailmgr'</TT> by default, of
    87 either the user's home directory or the domain subdirectory.  
    95 either the user's home directory or the domain subdirectory.  
    88 If a file matching the configuration name is found in one of the local
    96 If a file matching the configuration name is found in one of the local
    89 directories, the search stops and it is not searched for in any
    97 directories, the search stops and it is not searched for in any
    90 higher up directories.
    98 higher up directories.
    91 
    99 <P>
    92 
   100 
    93 
   101 <A NAME="File Types"></A>
    94 
   102 <HR SIZE="6">
    95 <H2><A NAME="SEC3" HREF="configuration.html#TOC3">1.2 File Types</A></H2>
   103 <A NAME="SEC3"></A>
    96 
   104 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
    97 <P>
   105 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC2"> &lt; </A>]</TD>
       
   106 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC4"> &gt; </A>]</TD>
       
   107 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> &lt;&lt; </A>]</TD>
       
   108 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> Up </A>]</TD>
       
   109 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &gt;&gt; </A>]</TD>
       
   110 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   111 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   112 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   113 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   114 </TR></TABLE>
       
   115 <H2> 1.2 File Types </H2>
       
   116 <!--docid::SEC3::-->
       
   117 <P>
       
   118 
    98 Each of the configuration files falls into one of the following types:
   119 Each of the configuration files falls into one of the following types:
    99 
   120 </P><P>
   100 
   121 
   101 <DL COMPACT>
   122 <DL COMPACT>
   102 
   123 
   103 <DT>String
   124 <DT>String
   104 <DD>
   125 <DD><P>
       
   126 
   105 A single line is read from this type and used as-is with no conversion.
   127 A single line is read from this type and used as-is with no conversion.
   106 All data after the first line is ignored.
   128 All data after the first line is ignored.
       
   129 </P><P>
   107 
   130 
   108 <DT>Directory
   131 <DT>Directory
   109 <DD>
   132 <DD><P>
       
   133 
   110 A single line is read from this type.
   134 A single line is read from this type.
   111 If it does not have a trailing slash (<SAMP>`/'</SAMP>), one is appended.
   135 If it does not have a trailing slash (<SAMP>`/'</SAMP>), one is appended.
   112 All data after the first line is ignored.
   136 All data after the first line is ignored.
       
   137 </P><P>
   113 
   138 
   114 <DT>Number
   139 <DT>Number
   115 <DD>
   140 <DD><P>
       
   141 
   116 A single line is read from this type and converted to an unsigned
   142 A single line is read from this type and converted to an unsigned
   117 integer.
   143 integer.
   118 If the conversion succeeds, the value is used.
   144 If the conversion succeeds, the value is used.
   119 All data after the first line is ignored.
   145 All data after the first line is ignored.
       
   146 </P><P>
   120 
   147 
   121 <DT>List
   148 <DT>List
   122 <DD>
   149 <DD><P>
       
   150 
   123 Each line of the file is read, stripped of leading and trailing
   151 Each line of the file is read, stripped of leading and trailing
   124 whitespace, and treated as a separate value.
   152 whitespace, and treated as a separate value.
   125 Lines that contain only whitespace (ie blank lines) or lines beginning
   153 Lines that contain only whitespace (ie blank lines) or lines beginning
   126 with a pound symbol (<SAMP>`#'</SAMP>) are ignored.
   154 with a pound symbol (<SAMP>`#'</SAMP>) are ignored.
       
   155 </P><P>
   127 
   156 
   128 <DT>Executable
   157 <DT>Executable
   129 <DD>
   158 <DD><P>
       
   159 
   130 If the execute bits on the file are set, it is treated as an executable
   160 If the execute bits on the file are set, it is treated as an executable
   131 file and is executed with no interpretation by vmailmgr.
   161 file and is executed with no interpretation by vmailmgr.
   132 The the Command Execution section below for details.
   162 The the Command Execution section below for details.
   133 
   163 </P><P>
   134 </DL>
   164 
   135 
   165 </DL>
   136 <P>
   166 <P>
       
   167 
   137 All lines are stripped of any leading or trailing white space.
   168 All lines are stripped of any leading or trailing white space.
   138 
   169 </P><P>
   139 
   170 
   140 <P>
       
   141 Configuration files marked as <SAMP>`(global only)'</SAMP> are read
   171 Configuration files marked as <SAMP>`(global only)'</SAMP> are read
   142 before any user-level processing occurrs, and so are not functional in
   172 before any user-level processing occurrs, and so are not functional in
   143 the user-level configuration.
   173 the user-level configuration.
   144 
   174 </P><P>
   145 
   175 
   146 
   176 <A NAME="Command Execution"></A>
   147 
   177 <HR SIZE="6">
   148 <H2><A NAME="SEC4" HREF="configuration.html#TOC4">1.3 Command Execution</A></H2>
   178 <A NAME="SEC4"></A>
   149 
   179 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   150 <P>
   180 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC3"> &lt; </A>]</TD>
       
   181 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &gt; </A>]</TD>
       
   182 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> &lt;&lt; </A>]</TD>
       
   183 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> Up </A>]</TD>
       
   184 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &gt;&gt; </A>]</TD>
       
   185 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   186 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   187 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   188 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   189 </TR></TABLE>
       
   190 <H2> 1.3 Command Execution </H2>
       
   191 <!--docid::SEC4::-->
       
   192 <P>
       
   193 
   151 The following rules apply to executing a single command or a list of
   194 The following rules apply to executing a single command or a list of
   152 commands.
   195 commands.
   153 
   196 </P><P>
   154 
   197 
   155 <P>
       
   156 The executables are searched in reverse order of the configuration
   198 The executables are searched in reverse order of the configuration
   157 files.
   199 files.
   158 That is, the global setting is used first, and then the local settings.
   200 That is, the global setting is used first, and then the local settings.
   159 If the named file either does not exist in a directory or is not
   201 If the named file either does not exist in a directory or is not
   160 executable, that directory is skipped.
   202 executable, that directory is skipped.
   161 
   203 </P><P>
   162 
   204 
   163 <P>
       
   164 A command exit code of <SAMP>`99'</SAMP> indicates that the command completed
   205 A command exit code of <SAMP>`99'</SAMP> indicates that the command completed
   165 successfully but no further commands should be executed.
   206 successfully but no further commands should be executed.
   166 All other non-zero exit codes are treated as an error and will cause the
   207 All other non-zero exit codes are treated as an error and will cause the
   167 invoking program to stop with the same error code.
   208 invoking program to stop with the same error code.
   168 For <TT>`vdeliver'</TT>, an error exit of 111 will be passed up to qmail as a
   209 For <TT>`vdeliver'</TT>, an error exit of 111 will be passed up to qmail as a
   170 permanent failure.
   211 permanent failure.
   171 See the <TT>`qmail-command'</TT> man page for full details on delivery error
   212 See the <TT>`qmail-command'</TT> man page for full details on delivery error
   172 codes.
   213 codes.
   173 For <TT>`checkvpw'</TT>, any non-zero exit code (except as described above)
   214 For <TT>`checkvpw'</TT>, any non-zero exit code (except as described above)
   174 will cause authentication to fail.
   215 will cause authentication to fail.
   175 
   216 </P><P>
   176 
   217 
   177 <P>
       
   178 The following environment variables will be set (where applicable):
   218 The following environment variables will be set (where applicable):
   179 
   219 </P><P>
   180 
   220 
   181 <DL COMPACT>
   221 <DL COMPACT>
   182 
       
   183 <DT><SAMP>`HOME'</SAMP>
   222 <DT><SAMP>`HOME'</SAMP>
   184 <DD>
   223 <DD>The home directory of the real user.
   185 The home directory of the real user.
       
   186 <DT><SAMP>`MAILDIR'</SAMP>
   224 <DT><SAMP>`MAILDIR'</SAMP>
   187 <DD>
   225 <DD>The mail directory of the real or virtual user.
   188 The mail directory of the real or virtual user.
       
   189 <DT><SAMP>`USER'</SAMP>
   226 <DT><SAMP>`USER'</SAMP>
   190 <DD>
   227 <DD>The real user's name.
   191 The real user's name.
       
   192 <DT><SAMP>`VUSER'</SAMP>
   228 <DT><SAMP>`VUSER'</SAMP>
   193 <DD>
   229 <DD>The virtual user's name.
   194 The virtual user's name.
       
   195 For base user logins, this is blank, and all the following items
   230 For base user logins, this is blank, and all the following items
   196 prefixed with <SAMP>`VUSER_'</SAMP> are not set.
   231 prefixed with <SAMP>`VUSER_'</SAMP> are not set.
   197 <DT><SAMP>`VUSER_CTIME'</SAMP>
   232 <DT><SAMP>`VUSER_CTIME'</SAMP>
   198 <DD>
   233 <DD>The virtual user's creation time (or "0" if unknown).
   199 The virtual user's creation time (or "0" if unknown).
       
   200 <DT><SAMP>`VUSER_EXPIRY'</SAMP>
   234 <DT><SAMP>`VUSER_EXPIRY'</SAMP>
   201 <DD>
   235 <DD>The virtual user's expiry time (or "-" if not applicable).
   202 The virtual user's expiry time (or "-" if not applicable).
       
   203 <DT><SAMP>`VUSER_HARDQUOTA'</SAMP>
   236 <DT><SAMP>`VUSER_HARDQUOTA'</SAMP>
   204 <DD>
   237 <DD>The virtual user's total size hard quota (in bytes, or "-" if not applicable).
   205 The virtual user's total size hard quota (in bytes, or "-" if not applicable).
       
   206 <DT><SAMP>`VUSER_MSGCOUNT'</SAMP>
   238 <DT><SAMP>`VUSER_MSGCOUNT'</SAMP>
   207 <DD>
   239 <DD>The virtual user's message count limit (or "-" if not applicable).
   208 The virtual user's message count limit (or "-" if not applicable).
       
   209 <DT><SAMP>`VUSER_MSGSIZE'</SAMP>
   240 <DT><SAMP>`VUSER_MSGSIZE'</SAMP>
   210 <DD>
   241 <DD>The virtual user's message size limit (or "-" if not applicable).
   211 The virtual user's message size limit (or "-" if not applicable).
       
   212 <DT><SAMP>`VUSER_PERSONAL'</SAMP>
   242 <DT><SAMP>`VUSER_PERSONAL'</SAMP>
   213 <DD>
   243 <DD>The virtual user's personal data.
   214 The virtual user's personal data.
       
   215 <DT><SAMP>`VUSER_SOFTQUOTA'</SAMP>
   244 <DT><SAMP>`VUSER_SOFTQUOTA'</SAMP>
   216 <DD>
   245 <DD>The virtual user's total size soft quota (in bytes, or "-" if not applicable).
   217 The virtual user's total size soft quota (in bytes, or "-" if not applicable).
   246 </DL>
   218 </DL>
   247 <P>
   219 
   248 
   220 
   249 <A NAME="Configuration Files"></A>
   221 
   250 <HR SIZE="6">
   222 <H1><A NAME="SEC5" HREF="configuration.html#TOC5">2. Configuration Files</A></H1>
   251 <A NAME="SEC5"></A>
   223 
   252 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   224 <P>
   253 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC4"> &lt; </A>]</TD>
       
   254 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC6"> &gt; </A>]</TD>
       
   255 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC1"> &lt;&lt; </A>]</TD>
       
   256 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top"> Up </A>]</TD>
       
   257 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   258 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   259 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   260 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   261 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   262 </TR></TABLE>
       
   263 <H1> 2. Configuration Files </H1>
       
   264 <!--docid::SEC5::-->
       
   265 <P>
       
   266 
   225 Each of the following sections identifies a single configuration file
   267 Each of the following sections identifies a single configuration file
   226 
   268 </P><P>
   227 
   269 
   228 
   270 <BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0> 
   229 
   271 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC6">2.1 authvmailmgr-error</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   230 <H2><A NAME="SEC6" HREF="configuration.html#TOC6">2.1 authvmailmgr-error</A></H2>
   272 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC7">2.2 authvmailmgr-loginfail</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   231 
   273 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC8">2.3 authvmailmgr-postsetuid</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   232 <DL COMPACT>
   274 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC9">2.4 authvmailmgr-presetuid</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   233 
   275 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC10">2.5 autoresponse-dir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   234 <DT><STRONG>Type</STRONG>
   276 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC11">2.6 autoresponse-file</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   235 <DD>
   277 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC12">2.7 bulletin-dir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   236 executable
   278 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC13">2.8 checkvpw-error</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   237 <DT><STRONG>Default</STRONG>
   279 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC14">2.9 checkvpw-loginfail</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   238 <DD>
   280 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC15">2.10 checkvpw-postexec</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   239 Empty
   281 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC16">2.11 checkvpw-postsetuid</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   240 <DT><STRONG>Used By</STRONG>
   282 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC17">2.12 checkvpw-presetuid</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   241 <DD>
   283 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC18">2.13 default-expiry</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   242 authvmailmgr
   284 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC19">2.14 default-maildir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   243 <DT><STRONG>Description</STRONG>
   285 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC20">2.15 default-msgcount</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   244 <DD>
   286 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC21">2.16 default-msgsize</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
   245 This is executed by authvmailmgr if any error occurrs other than those
   287 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC22">2.17 default-hardquota</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   288 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC23">2.18 default-softquota</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   289 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC24">2.19 default-username</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   290 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC25">2.20 error-maildir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   291 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC26">2.21 global-bulletin-dir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   292 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC27">2.22 maildir-arg-str</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   293 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC28">2.23 password-file</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   294 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC29">2.24 postmaster-aliases</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   295 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC30">2.25 postmaster-email</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   296 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC31">2.26 qmail-root</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   297 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC32">2.27 separators</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   298 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC33">2.28 socket-file</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   299 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC34">2.29 user-dir</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   300 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC35">2.30 user-dir-bits</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   301 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC36">2.31 user-dir-slices</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   302 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC37">2.32 vdeliver-postdeliver</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   303 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC38">2.33 vdeliver-predeliver</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   304 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC39">2.34 vsetup-post</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   305 <TR><TD ALIGN="left" VALIGN="TOP"><A HREF="configuration.html#SEC40">2.35 vsetup-pre</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
       
   306 </TABLE></BLOCKQUOTE>
       
   307 <P>
       
   308 
       
   309 <A NAME="authvmailmgr-error"></A>
       
   310 <HR SIZE="6">
       
   311 <A NAME="SEC6"></A>
       
   312 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   313 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt; </A>]</TD>
       
   314 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC7"> &gt; </A>]</TD>
       
   315 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   316 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   317 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   318 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   319 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   320 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   321 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   322 </TR></TABLE>
       
   323 <H2> 2.1 authvmailmgr-error </H2>
       
   324 <!--docid::SEC6::-->
       
   325 <P>
       
   326 
       
   327 <DL COMPACT>
       
   328 <DT><STRONG>Type</STRONG>
       
   329 <DD>executable
       
   330 <DT><STRONG>Default</STRONG>
       
   331 <DD>Empty
       
   332 <DT><STRONG>Used By</STRONG>
       
   333 <DD>authvmailmgr
       
   334 <DT><STRONG>Description</STRONG>
       
   335 <DD>This is executed by authvmailmgr if any error occurrs other than those
   246 caught by <TT>`authvmailmgr-loginfail'</TT> below.
   336 caught by <TT>`authvmailmgr-loginfail'</TT> below.
   247 The environment variable <CODE>AUTHVMAILMGR_ERROR</CODE> will contain an error
   337 The environment variable <CODE>AUTHVMAILMGR_ERROR</CODE> will contain an error
   248 message.
   338 message.
   249 This can be used to output logging messages about errors in authvmailmgr.
   339 This can be used to output logging messages about errors in authvmailmgr.
   250 </DL>
   340 </DL>
   251 
   341 <P>
   252 
   342 
   253 
   343 <A NAME="authvmailmgr-loginfail"></A>
   254 <H2><A NAME="SEC7" HREF="configuration.html#TOC7">2.2 authvmailmgr-loginfail</A></H2>
   344 <HR SIZE="6">
   255 
   345 <A NAME="SEC7"></A>
   256 <DL COMPACT>
   346 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   257 
   347 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC6"> &lt; </A>]</TD>
   258 <DT><STRONG>Type</STRONG>
   348 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC8"> &gt; </A>]</TD>
   259 <DD>
   349 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   260 executable
   350 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   261 <DT><STRONG>Default</STRONG>
   351 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   262 <DD>
   352 <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="configuration.html#SEC_Top">Top</A>]</TD>
   263 Empty
   353 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   264 <DT><STRONG>Used By</STRONG>
   354 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   265 <DD>
   355 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   266 authvmailmgr
   356 </TR></TABLE>
   267 <DT><STRONG>Description</STRONG>
   357 <H2> 2.2 authvmailmgr-loginfail </H2>
   268 <DD>
   358 <!--docid::SEC7::-->
   269 This is executed by authvmailmgr if the user's login fails.
   359 <P>
       
   360 
       
   361 <DL COMPACT>
       
   362 <DT><STRONG>Type</STRONG>
       
   363 <DD>executable
       
   364 <DT><STRONG>Default</STRONG>
       
   365 <DD>Empty
       
   366 <DT><STRONG>Used By</STRONG>
       
   367 <DD>authvmailmgr
       
   368 <DT><STRONG>Description</STRONG>
       
   369 <DD>This is executed by authvmailmgr if the user's login fails.
   270 The environment variable <CODE>AUTHVMAILMGR_ERROR</CODE> will contain an error
   370 The environment variable <CODE>AUTHVMAILMGR_ERROR</CODE> will contain an error
   271 message.
   371 message.
   272 The environment variable <CODE>VUSER</CODE> will be set to the virtual user
   372 The environment variable <CODE>VUSER</CODE> will be set to the virtual user
   273 name if it has been determined.
   373 name if it has been determined.
   274 This can be used to output logging messages about login failures or to
   374 This can be used to output logging messages about login failures or to
   275 throttle hackers.
   375 throttle hackers.
   276 </DL>
   376 </DL>
   277 
   377 <P>
   278 
   378 
   279 
   379 <A NAME="authvmailmgr-postsetuid"></A>
   280 <H2><A NAME="SEC8" HREF="configuration.html#TOC8">2.3 authvmailmgr-postsetuid</A></H2>
   380 <HR SIZE="6">
   281 
   381 <A NAME="SEC8"></A>
   282 <DL COMPACT>
   382 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   283 
   383 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC7"> &lt; </A>]</TD>
   284 <DT><STRONG>Type</STRONG>
   384 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC9"> &gt; </A>]</TD>
   285 <DD>
   385 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   286 executable
   386 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   287 <DT><STRONG>Default</STRONG>
   387 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   288 <DD>
   388 <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="configuration.html#SEC_Top">Top</A>]</TD>
   289 @samp {vpopbull}
   389 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   290 <DT><STRONG>Used By</STRONG>
   390 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   291 <DD>
   391 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   292 authvmailmgr
   392 </TR></TABLE>
   293 <DT><STRONG>Description</STRONG>
   393 <H2> 2.3 authvmailmgr-postsetuid </H2>
   294 <DD>
   394 <!--docid::SEC8::-->
   295 This is executed by authvmailmgr after a user is successfully authenticated.
   395 <P>
   296 </DL>
   396 
   297 
   397 <DL COMPACT>
   298 
   398 <DT><STRONG>Type</STRONG>
   299 
   399 <DD>executable
   300 <H2><A NAME="SEC9" HREF="configuration.html#TOC9">2.4 authvmailmgr-presetuid</A></H2>
   400 <DT><STRONG>Default</STRONG>
   301 
   401 <DD><SAMP>`vpopbull'</SAMP>
   302 <DL COMPACT>
   402 <DT><STRONG>Used By</STRONG>
   303 
   403 <DD>authvmailmgr
   304 <DT><STRONG>Type</STRONG>
   404 <DT><STRONG>Description</STRONG>
   305 <DD>
   405 <DD>This is executed by authvmailmgr after a user is successfully authenticated.
   306 executable
   406 </DL>
   307 <DT><STRONG>Default</STRONG>
   407 <P>
   308 <DD>
   408 
   309 Empty
   409 <A NAME="authvmailmgr-presetuid"></A>
   310 <DT><STRONG>Used By</STRONG>
   410 <HR SIZE="6">
   311 <DD>
   411 <A NAME="SEC9"></A>
   312 authvmailmgr
   412 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   313 <DT><STRONG>Description</STRONG>
   413 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC8"> &lt; </A>]</TD>
   314 <DD>
   414 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC10"> &gt; </A>]</TD>
   315 This list is executed by authvmailmgr before changing user away from root,
   415 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   416 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   417 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   418 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   419 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   420 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   421 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   422 </TR></TABLE>
       
   423 <H2> 2.4 authvmailmgr-presetuid </H2>
       
   424 <!--docid::SEC9::-->
       
   425 <P>
       
   426 
       
   427 <DL COMPACT>
       
   428 <DT><STRONG>Type</STRONG>
       
   429 <DD>executable
       
   430 <DT><STRONG>Default</STRONG>
       
   431 <DD>Empty
       
   432 <DT><STRONG>Used By</STRONG>
       
   433 <DD>authvmailmgr
       
   434 <DT><STRONG>Description</STRONG>
       
   435 <DD>This list is executed by authvmailmgr before changing user away from root,
   316 and before authenticating a virtual user.
   436 and before authenticating a virtual user.
   317 Note: The environment variable <SAMP>`MAILDIR'</SAMP> is not set since the
   437 Note: The environment variable <SAMP>`MAILDIR'</SAMP> is not set since the
   318 virtual user has not yet been authenticated, or even looked up
   438 virtual user has not yet been authenticated, or even looked up
   319 at this point.
   439 at this point.
   320 For the same reason, <SAMP>`VUSER'</SAMP> is not authenticated and is under
   440 For the same reason, <SAMP>`VUSER'</SAMP> is not authenticated and is under
   321 complete control of the invoking user.
   441 complete control of the invoking user.
   322 </DL>
   442 </DL>
   323 
   443 <P>
   324 
   444 
   325 
   445 <A NAME="autoresponse-dir"></A>
   326 <H2><A NAME="SEC10" HREF="configuration.html#TOC10">2.5 autoresponse-dir</A></H2>
   446 <HR SIZE="6">
   327 
   447 <A NAME="SEC10"></A>
   328 <DL COMPACT>
   448 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   329 
   449 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC9"> &lt; </A>]</TD>
   330 <DT><STRONG>Type</STRONG>
   450 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC11"> &gt; </A>]</TD>
   331 <DD>
   451 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   332 directory
   452 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   333 <DT><STRONG>Default</STRONG>
   453 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   334 <DD>
   454 <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="configuration.html#SEC_Top">Top</A>]</TD>
   335 <SAMP>`autoresponse'</SAMP>
   455 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   336 <DT><STRONG>Used By</STRONG>
   456 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   337 <DD>
   457 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   338 vmailmgrd, autoresponder script
   458 </TR></TABLE>
   339 <DT><STRONG>Description</STRONG>
   459 <H2> 2.5 autoresponse-dir </H2>
   340 <DD>
   460 <!--docid::SEC10::-->
   341 Identifies the subdirectory of the virtual user directory in which all
   461 <P>
       
   462 
       
   463 <DL COMPACT>
       
   464 <DT><STRONG>Type</STRONG>
       
   465 <DD>directory
       
   466 <DT><STRONG>Default</STRONG>
       
   467 <DD><SAMP>`autoresponse'</SAMP>
       
   468 <DT><STRONG>Used By</STRONG>
       
   469 <DD>vmailmgrd, autoresponder script
       
   470 <DT><STRONG>Description</STRONG>
       
   471 <DD>Identifies the subdirectory of the virtual user directory in which all
   342 autoresponse data is stored.
   472 autoresponse data is stored.
   343 </DL>
   473 </DL>
   344 
   474 <P>
   345 
   475 
   346 
   476 <A NAME="autoresponse-file"></A>
   347 <H2><A NAME="SEC11" HREF="configuration.html#TOC11">2.6 autoresponse-file</A></H2>
   477 <HR SIZE="6">
   348 
   478 <A NAME="SEC11"></A>
   349 <DL COMPACT>
   479 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   350 
   480 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC10"> &lt; </A>]</TD>
   351 <DT><STRONG>Type</STRONG>
   481 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC12"> &gt; </A>]</TD>
   352 <DD>
   482 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   353 string
   483 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   354 <DT><STRONG>Default</STRONG>
   484 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   355 <DD>
   485 <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="configuration.html#SEC_Top">Top</A>]</TD>
   356 <SAMP>`message.txt'</SAMP>
   486 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   357 <DT><STRONG>Used By</STRONG>
   487 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   358 <DD>
   488 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   359 vmailmgrd, autoresponder script
   489 </TR></TABLE>
   360 <DT><STRONG>Description</STRONG>
   490 <H2> 2.6 autoresponse-file </H2>
   361 <DD>
   491 <!--docid::SEC11::-->
   362 Identifies the file name within the autoresponse directory that contains
   492 <P>
       
   493 
       
   494 <DL COMPACT>
       
   495 <DT><STRONG>Type</STRONG>
       
   496 <DD>string
       
   497 <DT><STRONG>Default</STRONG>
       
   498 <DD><SAMP>`message.txt'</SAMP>
       
   499 <DT><STRONG>Used By</STRONG>
       
   500 <DD>vmailmgrd, autoresponder script
       
   501 <DT><STRONG>Description</STRONG>
       
   502 <DD>Identifies the file name within the autoresponse directory that contains
   363 the autoresponse message.
   503 the autoresponse message.
   364 </DL>
   504 </DL>
   365 
   505 <P>
   366 
   506 
   367 
   507 <A NAME="bulletin-dir"></A>
   368 <H2><A NAME="SEC12" HREF="configuration.html#TOC12">2.7 bulletin-dir</A></H2>
   508 <HR SIZE="6">
   369 
   509 <A NAME="SEC12"></A>
   370 <DL COMPACT>
   510 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   371 
   511 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC11"> &lt; </A>]</TD>
   372 <DT><STRONG>Type</STRONG>
   512 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC13"> &gt; </A>]</TD>
   373 <DD>
   513 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   374 directory
   514 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   375 <DT><STRONG>Default</STRONG>
   515 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   376 <DD>
   516 <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="configuration.html#SEC_Top">Top</A>]</TD>
   377 <SAMP>`bulletins'</SAMP>
   517 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   378 <DT><STRONG>Used By</STRONG>
   518 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   379 <DD>
   519 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   380 checkvpw
   520 </TR></TABLE>
   381 <DT><STRONG>Description</STRONG>
   521 <H2> 2.7 bulletin-dir </H2>
   382 <DD>
   522 <!--docid::SEC12::-->
   383 Identifies the subdirectory of the domain directory in which bulletins
   523 <P>
       
   524 
       
   525 <DL COMPACT>
       
   526 <DT><STRONG>Type</STRONG>
       
   527 <DD>directory
       
   528 <DT><STRONG>Default</STRONG>
       
   529 <DD><SAMP>`bulletins'</SAMP>
       
   530 <DT><STRONG>Used By</STRONG>
       
   531 <DD>checkvpw
       
   532 <DT><STRONG>Description</STRONG>
       
   533 <DD>Identifies the subdirectory of the domain directory in which bulletins
   384 local to a domain are stored.
   534 local to a domain are stored.
   385 </DL>
   535 </DL>
   386 
   536 <P>
   387 
   537 
   388 
   538 <A NAME="checkvpw-error"></A>
   389 <H2><A NAME="SEC13" HREF="configuration.html#TOC13">2.8 checkvpw-error</A></H2>
   539 <HR SIZE="6">
   390 
   540 <A NAME="SEC13"></A>
   391 <DL COMPACT>
   541 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   392 
   542 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC12"> &lt; </A>]</TD>
   393 <DT><STRONG>Type</STRONG>
   543 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC14"> &gt; </A>]</TD>
   394 <DD>
   544 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   395 executable
   545 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   396 <DT><STRONG>Default</STRONG>
   546 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   397 <DD>
   547 <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="configuration.html#SEC_Top">Top</A>]</TD>
   398 Empty
   548 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   399 <DT><STRONG>Used By</STRONG>
   549 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   400 <DD>
   550 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   401 checkvpw
   551 </TR></TABLE>
   402 <DT><STRONG>Description</STRONG>
   552 <H2> 2.8 checkvpw-error </H2>
   403 <DD>
   553 <!--docid::SEC13::-->
   404 This is executed by checkvpw if any error occurrs other than those
   554 <P>
       
   555 
       
   556 <DL COMPACT>
       
   557 <DT><STRONG>Type</STRONG>
       
   558 <DD>executable
       
   559 <DT><STRONG>Default</STRONG>
       
   560 <DD>Empty
       
   561 <DT><STRONG>Used By</STRONG>
       
   562 <DD>checkvpw
       
   563 <DT><STRONG>Description</STRONG>
       
   564 <DD>This is executed by checkvpw if any error occurrs other than those
   405 caught by <TT>`checkvpw-loginfail'</TT> below.
   565 caught by <TT>`checkvpw-loginfail'</TT> below.
   406 The environment variable <CODE>CHECKVPW_ERROR</CODE> will contain an error
   566 The environment variable <CODE>CHECKVPW_ERROR</CODE> will contain an error
   407 message.
   567 message.
   408 This can be used to output logging messages about errors in checkvpw.
   568 This can be used to output logging messages about errors in checkvpw.
   409 </DL>
   569 </DL>
   410 
   570 <P>
   411 
   571 
   412 
   572 <A NAME="checkvpw-loginfail"></A>
   413 <H2><A NAME="SEC14" HREF="configuration.html#TOC14">2.9 checkvpw-loginfail</A></H2>
   573 <HR SIZE="6">
   414 
   574 <A NAME="SEC14"></A>
   415 <DL COMPACT>
   575 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   416 
   576 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC13"> &lt; </A>]</TD>
   417 <DT><STRONG>Type</STRONG>
   577 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC15"> &gt; </A>]</TD>
   418 <DD>
   578 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   419 executable
   579 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   420 <DT><STRONG>Default</STRONG>
   580 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   421 <DD>
   581 <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="configuration.html#SEC_Top">Top</A>]</TD>
   422 Empty
   582 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   423 <DT><STRONG>Used By</STRONG>
   583 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   424 <DD>
   584 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   425 checkvpw
   585 </TR></TABLE>
   426 <DT><STRONG>Description</STRONG>
   586 <H2> 2.9 checkvpw-loginfail </H2>
   427 <DD>
   587 <!--docid::SEC14::-->
   428 This is executed by checkvpw if the user's login fails.
   588 <P>
       
   589 
       
   590 <DL COMPACT>
       
   591 <DT><STRONG>Type</STRONG>
       
   592 <DD>executable
       
   593 <DT><STRONG>Default</STRONG>
       
   594 <DD>Empty
       
   595 <DT><STRONG>Used By</STRONG>
       
   596 <DD>checkvpw
       
   597 <DT><STRONG>Description</STRONG>
       
   598 <DD>This is executed by checkvpw if the user's login fails.
   429 The environment variable <CODE>CHECKVPW_ERROR</CODE> will contain an error
   599 The environment variable <CODE>CHECKVPW_ERROR</CODE> will contain an error
   430 message.
   600 message.
   431 The environment variable <CODE>VUSER</CODE> will be set to the virtual user
   601 The environment variable <CODE>VUSER</CODE> will be set to the virtual user
   432 name if it has been determined.
   602 name if it has been determined.
   433 This can be used to output logging messages about login failures or to
   603 This can be used to output logging messages about login failures or to
   434 throttle hackers.
   604 throttle hackers.
   435 </DL>
   605 </DL>
   436 
   606 <P>
   437 
   607 
   438 
   608 <A NAME="checkvpw-postexec"></A>
   439 <H2><A NAME="SEC15" HREF="configuration.html#TOC15">2.10 checkvpw-postexec</A></H2>
   609 <HR SIZE="6">
   440 
   610 <A NAME="SEC15"></A>
   441 <DL COMPACT>
   611 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   442 
   612 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC14"> &lt; </A>]</TD>
   443 <DT><STRONG>Type</STRONG>
   613 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC16"> &gt; </A>]</TD>
   444 <DD>
   614 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   445 executable
   615 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   446 <DT><STRONG>Default</STRONG>
   616 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   447 <DD>
   617 <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="configuration.html#SEC_Top">Top</A>]</TD>
   448 Empty
   618 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   449 <DT><STRONG>Used By</STRONG>
   619 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   450 <DD>
   620 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   451 checkvpw
   621 </TR></TABLE>
   452 <DT><STRONG>Description</STRONG>
   622 <H2> 2.10 checkvpw-postexec </H2>
   453 <DD>
   623 <!--docid::SEC15::-->
   454 This is executed by checkvpw after the subcommand successfully completes.
   624 <P>
   455 </DL>
   625 
   456 
   626 <DL COMPACT>
   457 
   627 <DT><STRONG>Type</STRONG>
   458 
   628 <DD>executable
   459 <H2><A NAME="SEC16" HREF="configuration.html#TOC16">2.11 checkvpw-postsetuid</A></H2>
   629 <DT><STRONG>Default</STRONG>
   460 
   630 <DD>Empty
   461 <DL COMPACT>
   631 <DT><STRONG>Used By</STRONG>
   462 
   632 <DD>checkvpw
   463 <DT><STRONG>Type</STRONG>
   633 <DT><STRONG>Description</STRONG>
   464 <DD>
   634 <DD>This is executed by checkvpw after the subcommand successfully completes.
   465 executable
   635 </DL>
   466 <DT><STRONG>Default</STRONG>
   636 <P>
   467 <DD>
   637 
   468 @samp {vpopbull}
   638 <A NAME="checkvpw-postsetuid"></A>
   469 <DT><STRONG>Used By</STRONG>
   639 <HR SIZE="6">
   470 <DD>
   640 <A NAME="SEC16"></A>
   471 checkvpw
   641 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   472 <DT><STRONG>Description</STRONG>
   642 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC15"> &lt; </A>]</TD>
   473 <DD>
   643 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC17"> &gt; </A>]</TD>
   474 This is executed by checkvpw after a user is successfully authenticated.
   644 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   475 </DL>
   645 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   476 
   646 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   477 
   647 <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="configuration.html#SEC_Top">Top</A>]</TD>
   478 
   648 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   479 <H2><A NAME="SEC17" HREF="configuration.html#TOC17">2.12 checkvpw-presetuid</A></H2>
   649 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   480 
   650 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   481 <DL COMPACT>
   651 </TR></TABLE>
   482 
   652 <H2> 2.11 checkvpw-postsetuid </H2>
   483 <DT><STRONG>Type</STRONG>
   653 <!--docid::SEC16::-->
   484 <DD>
   654 <P>
   485 executable
   655 
   486 <DT><STRONG>Default</STRONG>
   656 <DL COMPACT>
   487 <DD>
   657 <DT><STRONG>Type</STRONG>
   488 Empty
   658 <DD>executable
   489 <DT><STRONG>Used By</STRONG>
   659 <DT><STRONG>Default</STRONG>
   490 <DD>
   660 <DD><SAMP>`vpopbull'</SAMP>
   491 checkvpw
   661 <DT><STRONG>Used By</STRONG>
   492 <DT><STRONG>Description</STRONG>
   662 <DD>checkvpw
   493 <DD>
   663 <DT><STRONG>Description</STRONG>
   494 This list is executed by checkvpw before changing user away from root,
   664 <DD>This is executed by checkvpw after a user is successfully authenticated.
       
   665 </DL>
       
   666 <P>
       
   667 
       
   668 <A NAME="checkvpw-presetuid"></A>
       
   669 <HR SIZE="6">
       
   670 <A NAME="SEC17"></A>
       
   671 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   672 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC16"> &lt; </A>]</TD>
       
   673 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC18"> &gt; </A>]</TD>
       
   674 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   675 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   676 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   677 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   678 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   679 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   680 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   681 </TR></TABLE>
       
   682 <H2> 2.12 checkvpw-presetuid </H2>
       
   683 <!--docid::SEC17::-->
       
   684 <P>
       
   685 
       
   686 <DL COMPACT>
       
   687 <DT><STRONG>Type</STRONG>
       
   688 <DD>executable
       
   689 <DT><STRONG>Default</STRONG>
       
   690 <DD>Empty
       
   691 <DT><STRONG>Used By</STRONG>
       
   692 <DD>checkvpw
       
   693 <DT><STRONG>Description</STRONG>
       
   694 <DD>This list is executed by checkvpw before changing user away from root,
   495 and before authenticating a virtual user.
   695 and before authenticating a virtual user.
   496 Note: The environment variable <SAMP>`MAILDIR'</SAMP> is not set since the
   696 Note: The environment variable <SAMP>`MAILDIR'</SAMP> is not set since the
   497 virtual user has not yet been authenticated, or even looked up
   697 virtual user has not yet been authenticated, or even looked up
   498 at this point.
   698 at this point.
   499 For the same reason, <SAMP>`VUSER'</SAMP> is not authenticated and is under
   699 For the same reason, <SAMP>`VUSER'</SAMP> is not authenticated and is under
   500 complete control of the invoking user.
   700 complete control of the invoking user.
   501 </DL>
   701 </DL>
   502 
   702 <P>
   503 
   703 
   504 
   704 <A NAME="default-expiry"></A>
   505 <H2><A NAME="SEC18" HREF="configuration.html#TOC18">2.13 default-expiry</A></H2>
   705 <HR SIZE="6">
   506 
   706 <A NAME="SEC18"></A>
   507 <DL COMPACT>
   707 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   508 
   708 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC17"> &lt; </A>]</TD>
   509 <DT><STRONG>Type</STRONG>
   709 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC19"> &gt; </A>]</TD>
   510 <DD>
   710 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   511 number
   711 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   512 <DT><STRONG>Default</STRONG>
   712 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   513 <DD>
   713 <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="configuration.html#SEC_Top">Top</A>]</TD>
   514 <SAMP>`-1'</SAMP>
   714 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   515 <DT><STRONG>Used By</STRONG>
   715 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   516 <DD>
   716 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   517 vadduser
   717 </TR></TABLE>
   518 <DT><STRONG>Description</STRONG>
   718 <H2> 2.13 default-expiry </H2>
   519 <DD>
   719 <!--docid::SEC18::-->
   520 Sets the default expiry value for newly created users.
   720 <P>
       
   721 
       
   722 <DL COMPACT>
       
   723 <DT><STRONG>Type</STRONG>
       
   724 <DD>number
       
   725 <DT><STRONG>Default</STRONG>
       
   726 <DD><SAMP>`-1'</SAMP>
       
   727 <DT><STRONG>Used By</STRONG>
       
   728 <DD>vadduser
       
   729 <DT><STRONG>Description</STRONG>
       
   730 <DD>Sets the default expiry value for newly created users.
   521 Negative values indicate no expiry.
   731 Negative values indicate no expiry.
   522 </DL>
   732 </DL>
   523 
   733 <P>
   524 
   734 
   525 
   735 <A NAME="default-maildir"></A>
   526 <H2><A NAME="SEC19" HREF="configuration.html#TOC19">2.14 default-maildir</A></H2>
   736 <HR SIZE="6">
   527 
   737 <A NAME="SEC19"></A>
   528 <DL COMPACT>
   738 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   529 
   739 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC18"> &lt; </A>]</TD>
   530 <DT><STRONG>Type</STRONG>
   740 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC20"> &gt; </A>]</TD>
   531 <DD>
   741 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   532 directory
   742 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   533 <DT><STRONG>Default</STRONG>
   743 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   534 <DD>
   744 <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="configuration.html#SEC_Top">Top</A>]</TD>
   535 <SAMP>`Maildir'</SAMP>
   745 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   536 <DT><STRONG>Used By</STRONG>
   746 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   537 <DD>
   747 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   538 checkvpw
   748 </TR></TABLE>
   539 <DT><STRONG>Description</STRONG>
   749 <H2> 2.14 default-maildir </H2>
   540 <DD>
   750 <!--docid::SEC19::-->
   541 Sets the name of the directory to be used as a non-virtual user's maildir.
   751 <P>
   542 </DL>
   752 
   543 
   753 <DL COMPACT>
   544 
   754 <DT><STRONG>Type</STRONG>
   545 
   755 <DD>directory
   546 <H2><A NAME="SEC20" HREF="configuration.html#TOC20">2.15 default-msgcount</A></H2>
   756 <DT><STRONG>Default</STRONG>
   547 
   757 <DD><SAMP>`Maildir'</SAMP>
   548 <DL COMPACT>
   758 <DT><STRONG>Used By</STRONG>
   549 
   759 <DD>checkvpw
   550 <DT><STRONG>Type</STRONG>
   760 <DT><STRONG>Description</STRONG>
   551 <DD>
   761 <DD>Sets the name of the directory to be used as a non-virtual user's maildir.
   552 number
   762 </DL>
   553 <DT><STRONG>Default</STRONG>
   763 <P>
   554 <DD>
   764 
   555 <SAMP>`-1'</SAMP>
   765 <A NAME="default-msgcount"></A>
   556 <DT><STRONG>Used By</STRONG>
   766 <HR SIZE="6">
   557 <DD>
   767 <A NAME="SEC20"></A>
   558 vadduser
   768 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   559 <DT><STRONG>Description</STRONG>
   769 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC19"> &lt; </A>]</TD>
   560 <DD>
   770 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC21"> &gt; </A>]</TD>
   561 Sets the default message count limit.
   771 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   562 </DL>
   772 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   563 
   773 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   564 
   774 <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="configuration.html#SEC_Top">Top</A>]</TD>
   565 
   775 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   566 <H2><A NAME="SEC21" HREF="configuration.html#TOC21">2.16 default-msgsize</A></H2>
   776 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   567 
   777 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   568 <DL COMPACT>
   778 </TR></TABLE>
   569 
   779 <H2> 2.15 default-msgcount </H2>
   570 <DT><STRONG>Type</STRONG>
   780 <!--docid::SEC20::-->
   571 <DD>
   781 <P>
   572 number
   782 
   573 <DT><STRONG>Default</STRONG>
   783 <DL COMPACT>
   574 <DD>
   784 <DT><STRONG>Type</STRONG>
   575 <SAMP>`-1'</SAMP>
   785 <DD>number
   576 <DT><STRONG>Used By</STRONG>
   786 <DT><STRONG>Default</STRONG>
   577 <DD>
   787 <DD><SAMP>`-1'</SAMP>
   578 vadduser
   788 <DT><STRONG>Used By</STRONG>
   579 <DT><STRONG>Description</STRONG>
   789 <DD>vadduser
   580 <DD>
   790 <DT><STRONG>Description</STRONG>
   581 Sets the default message size limit, in bytes.
   791 <DD>Sets the default message count limit.
   582 </DL>
   792 </DL>
   583 
   793 <P>
   584 
   794 
   585 
   795 <A NAME="default-msgsize"></A>
   586 <H2><A NAME="SEC22" HREF="configuration.html#TOC22">2.17 default-hardquota</A></H2>
   796 <HR SIZE="6">
   587 
   797 <A NAME="SEC21"></A>
   588 <DL COMPACT>
   798 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   589 
   799 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC20"> &lt; </A>]</TD>
   590 <DT><STRONG>Type</STRONG>
   800 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC22"> &gt; </A>]</TD>
   591 <DD>
   801 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   592 number
   802 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   593 <DT><STRONG>Default</STRONG>
   803 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   594 <DD>
   804 <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="configuration.html#SEC_Top">Top</A>]</TD>
   595 <SAMP>`-1'</SAMP>
   805 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   596 <DT><STRONG>Used By</STRONG>
   806 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   597 <DD>
   807 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   598 vadduser
   808 </TR></TABLE>
   599 <DT><STRONG>Description</STRONG>
   809 <H2> 2.16 default-msgsize </H2>
   600 <DD>
   810 <!--docid::SEC21::-->
   601 Sets the default hard quota, in bytes.
   811 <P>
   602 </DL>
   812 
   603 
   813 <DL COMPACT>
   604 
   814 <DT><STRONG>Type</STRONG>
   605 
   815 <DD>number
   606 <H2><A NAME="SEC23" HREF="configuration.html#TOC23">2.18 default-softquota</A></H2>
   816 <DT><STRONG>Default</STRONG>
   607 
   817 <DD><SAMP>`-1'</SAMP>
   608 <DL COMPACT>
   818 <DT><STRONG>Used By</STRONG>
   609 
   819 <DD>vadduser
   610 <DT><STRONG>Type</STRONG>
   820 <DT><STRONG>Description</STRONG>
   611 <DD>
   821 <DD>Sets the default message size limit, in bytes.
   612 number
   822 </DL>
   613 <DT><STRONG>Default</STRONG>
   823 <P>
   614 <DD>
   824 
   615 <SAMP>`-1'</SAMP>
   825 <A NAME="default-hardquota"></A>
   616 <DT><STRONG>Used By</STRONG>
   826 <HR SIZE="6">
   617 <DD>
   827 <A NAME="SEC22"></A>
   618 vadduser
   828 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   619 <DT><STRONG>Description</STRONG>
   829 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC21"> &lt; </A>]</TD>
   620 <DD>
   830 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC23"> &gt; </A>]</TD>
   621 Sets the default soft quota, in bytes.
   831 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   622 </DL>
   832 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   623 
   833 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   624 
   834 <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="configuration.html#SEC_Top">Top</A>]</TD>
   625 
   835 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   626 <H2><A NAME="SEC24" HREF="configuration.html#TOC24">2.19 default-username</A></H2>
   836 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   627 
   837 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   628 <DL COMPACT>
   838 </TR></TABLE>
   629 
   839 <H2> 2.17 default-hardquota </H2>
   630 <DT><STRONG>Type</STRONG>
   840 <!--docid::SEC22::-->
   631 <DD>
   841 <P>
   632 string
   842 
   633 <DT><STRONG>Default</STRONG>
   843 <DL COMPACT>
   634 <DD>
   844 <DT><STRONG>Type</STRONG>
   635 <SAMP>`+'</SAMP>
   845 <DD>number
   636 <DT><STRONG>Used By</STRONG>
   846 <DT><STRONG>Default</STRONG>
   637 <DD>
   847 <DD><SAMP>`-1'</SAMP>
   638 vmailmgrd
   848 <DT><STRONG>Used By</STRONG>
   639 <DT><STRONG>Description</STRONG>
   849 <DD>vadduser
   640 <DD>
   850 <DT><STRONG>Description</STRONG>
   641 Identifies the name of the virtual user to be looked up if a lookup of
   851 <DD>Sets the default hard quota, in bytes.
       
   852 </DL>
       
   853 <P>
       
   854 
       
   855 <A NAME="default-softquota"></A>
       
   856 <HR SIZE="6">
       
   857 <A NAME="SEC23"></A>
       
   858 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   859 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC22"> &lt; </A>]</TD>
       
   860 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC24"> &gt; </A>]</TD>
       
   861 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   862 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   863 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   864 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   865 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   866 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   867 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   868 </TR></TABLE>
       
   869 <H2> 2.18 default-softquota </H2>
       
   870 <!--docid::SEC23::-->
       
   871 <P>
       
   872 
       
   873 <DL COMPACT>
       
   874 <DT><STRONG>Type</STRONG>
       
   875 <DD>number
       
   876 <DT><STRONG>Default</STRONG>
       
   877 <DD><SAMP>`-1'</SAMP>
       
   878 <DT><STRONG>Used By</STRONG>
       
   879 <DD>vadduser
       
   880 <DT><STRONG>Description</STRONG>
       
   881 <DD>Sets the default soft quota, in bytes.
       
   882 </DL>
       
   883 <P>
       
   884 
       
   885 <A NAME="default-username"></A>
       
   886 <HR SIZE="6">
       
   887 <A NAME="SEC24"></A>
       
   888 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
   889 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC23"> &lt; </A>]</TD>
       
   890 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC25"> &gt; </A>]</TD>
       
   891 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   892 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   893 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   894 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   895 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   896 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   897 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   898 </TR></TABLE>
       
   899 <H2> 2.19 default-username </H2>
       
   900 <!--docid::SEC24::-->
       
   901 <P>
       
   902 
       
   903 <DL COMPACT>
       
   904 <DT><STRONG>Type</STRONG>
       
   905 <DD>string
       
   906 <DT><STRONG>Default</STRONG>
       
   907 <DD><SAMP>`+'</SAMP>
       
   908 <DT><STRONG>Used By</STRONG>
       
   909 <DD>vmailmgrd
       
   910 <DT><STRONG>Description</STRONG>
       
   911 <DD>Identifies the name of the virtual user to be looked up if a lookup of
   642 another virtual user fails.
   912 another virtual user fails.
   643 </DL>
   913 </DL>
   644 
   914 <P>
   645 
   915 
   646 
   916 <A NAME="error-maildir"></A>
   647 <H2><A NAME="SEC25" HREF="configuration.html#TOC25">2.20 error-maildir</A></H2>
   917 <HR SIZE="6">
   648 
   918 <A NAME="SEC25"></A>
   649 <DL COMPACT>
   919 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   650 
   920 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC24"> &lt; </A>]</TD>
   651 <DT><STRONG>Type</STRONG>
   921 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC26"> &gt; </A>]</TD>
   652 <DD>
   922 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   653 directory
   923 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   654 <DT><STRONG>Default</STRONG>
   924 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   655 <DD>
   925 <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="configuration.html#SEC_Top">Top</A>]</TD>
   656 <SAMP>`/var/lib/vmailmgr/error-maildir'</SAMP>
   926 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   657 <DT><STRONG>Used By</STRONG>
   927 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   658 <DD>
   928 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   659 checkvpw
   929 </TR></TABLE>
   660 <DT><STRONG>Description</STRONG>
   930 <H2> 2.20 error-maildir </H2>
   661 <DD>
   931 <!--docid::SEC25::-->
   662 Specifies the path of a read-only maildir containing a message to be
   932 <P>
       
   933 
       
   934 <DL COMPACT>
       
   935 <DT><STRONG>Type</STRONG>
       
   936 <DD>directory
       
   937 <DT><STRONG>Default</STRONG>
       
   938 <DD><SAMP>`/var/lib/vmailmgr/error-maildir'</SAMP>
       
   939 <DT><STRONG>Used By</STRONG>
       
   940 <DD>checkvpw
       
   941 <DT><STRONG>Description</STRONG>
       
   942 <DD>Specifies the path of a read-only maildir containing a message to be
   663 sent to the user when the maildir corresponding to that user does not
   943 sent to the user when the maildir corresponding to that user does not
   664 exist.
   944 exist.
   665 </DL>
   945 </DL>
   666 
   946 <P>
   667 
   947 
   668 
   948 <A NAME="global-bulletin-dir"></A>
   669 <H2><A NAME="SEC26" HREF="configuration.html#TOC26">2.21 global-bulletin-dir</A></H2>
   949 <HR SIZE="6">
   670 
   950 <A NAME="SEC26"></A>
   671 <DL COMPACT>
   951 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   672 
   952 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC25"> &lt; </A>]</TD>
   673 <DT><STRONG>Type</STRONG>
   953 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC27"> &gt; </A>]</TD>
   674 <DD>
   954 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   675 directory
   955 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   676 <DT><STRONG>Default</STRONG>
   956 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   677 <DD>
   957 <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="configuration.html#SEC_Top">Top</A>]</TD>
   678 <SAMP>`/var/spool/bulletins'</SAMP>
   958 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   679 <DT><STRONG>Used By</STRONG>
   959 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   680 <DD>
   960 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   681 checkvpw
   961 </TR></TABLE>
   682 <DT><STRONG>Description</STRONG>
   962 <H2> 2.21 global-bulletin-dir </H2>
   683 <DD>
   963 <!--docid::SEC26::-->
   684 Identifies a site-wide bulletin directory.
   964 <P>
   685 </DL>
   965 
   686 
   966 <DL COMPACT>
   687 
   967 <DT><STRONG>Type</STRONG>
   688 
   968 <DD>directory
   689 <H2><A NAME="SEC27" HREF="configuration.html#TOC27">2.22 maildir-arg-str</A></H2>
   969 <DT><STRONG>Default</STRONG>
   690 
   970 <DD><SAMP>`/var/spool/bulletins'</SAMP>
   691 <DL COMPACT>
   971 <DT><STRONG>Used By</STRONG>
   692 
   972 <DD>checkvpw
   693 <DT><STRONG>Type</STRONG>
   973 <DT><STRONG>Description</STRONG>
   694 <DD>
   974 <DD>Identifies a site-wide bulletin directory.
   695 string
   975 </DL>
   696 <DT><STRONG>Default</STRONG>
   976 <P>
   697 <DD>
   977 
   698 <SAMP>`maildir'</SAMP>
   978 <A NAME="maildir-arg-str"></A>
   699 <DT><STRONG>Used By</STRONG>
   979 <HR SIZE="6">
   700 <DD>
   980 <A NAME="SEC27"></A>
   701 checkvpw (global only)
   981 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   702 <DT><STRONG>Description</STRONG>
   982 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC26"> &lt; </A>]</TD>
   703 <DD>
   983 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC28"> &gt; </A>]</TD>
   704 Identifies the string to search for when attempting to identify the
   984 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
   985 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
   986 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
   987 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
   988 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
   989 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
   990 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
   991 </TR></TABLE>
       
   992 <H2> 2.22 maildir-arg-str </H2>
       
   993 <!--docid::SEC27::-->
       
   994 <P>
       
   995 
       
   996 <DL COMPACT>
       
   997 <DT><STRONG>Type</STRONG>
       
   998 <DD>string
       
   999 <DT><STRONG>Default</STRONG>
       
  1000 <DD><SAMP>`maildir'</SAMP>
       
  1001 <DT><STRONG>Used By</STRONG>
       
  1002 <DD>checkvpw (global only)
       
  1003 <DT><STRONG>Description</STRONG>
       
  1004 <DD>Identifies the string to search for when attempting to identify the
   705 maildir argument on the command line to checkvpw.
  1005 maildir argument on the command line to checkvpw.
   706 </DL>
  1006 </DL>
   707 
  1007 <P>
   708 
  1008 
   709 
  1009 <A NAME="password-file"></A>
   710 <H2><A NAME="SEC28" HREF="configuration.html#TOC28">2.23 password-file</A></H2>
  1010 <HR SIZE="6">
   711 
  1011 <A NAME="SEC28"></A>
   712 <DL COMPACT>
  1012 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   713 
  1013 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC27"> &lt; </A>]</TD>
   714 <DT><STRONG>Type</STRONG>
  1014 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC29"> &gt; </A>]</TD>
   715 <DD>
  1015 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   716 string
  1016 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   717 <DT><STRONG>Default</STRONG>
  1017 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   718 <DD>
  1018 <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="configuration.html#SEC_Top">Top</A>]</TD>
   719 <SAMP>`passwd'</SAMP>
  1019 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   720 <DT><STRONG>Used By</STRONG>
  1020 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   721 <DD>
  1021 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   722 vmailmgrd and command-line programs
  1022 </TR></TABLE>
   723 <DT><STRONG>Description</STRONG>
  1023 <H2> 2.23 password-file </H2>
   724 <DD>
  1024 <!--docid::SEC28::-->
   725 Identifies the file that contains user names, passwords, and
  1025 <P>
       
  1026 
       
  1027 <DL COMPACT>
       
  1028 <DT><STRONG>Type</STRONG>
       
  1029 <DD>string
       
  1030 <DT><STRONG>Default</STRONG>
       
  1031 <DD><SAMP>`passwd'</SAMP>
       
  1032 <DT><STRONG>Used By</STRONG>
       
  1033 <DD>vmailmgrd and command-line programs
       
  1034 <DT><STRONG>Description</STRONG>
       
  1035 <DD>Identifies the file that contains user names, passwords, and
   726 destinations for a virtual domain.
  1036 destinations for a virtual domain.
   727 Note that this has nothing to do with "real" users, for which the
  1037 Note that this has nothing to do with "real" users, for which the
   728 password file is determined by the system libraries.
  1038 password file is determined by the system libraries.
   729 </DL>
  1039 </DL>
   730 
  1040 <P>
   731 
  1041 
   732 
  1042 <A NAME="postmaster-aliases"></A>
   733 <H2><A NAME="SEC29" HREF="configuration.html#TOC29">2.24 postmaster-aliases</A></H2>
  1043 <HR SIZE="6">
   734 
  1044 <A NAME="SEC29"></A>
   735 <DL COMPACT>
  1045 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   736 
  1046 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC28"> &lt; </A>]</TD>
   737 <DT><STRONG>Type</STRONG>
  1047 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC30"> &gt; </A>]</TD>
   738 <DD>
  1048 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   739 list
  1049 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   740 <DT><STRONG>Default</STRONG>
  1050 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   741 <DD>
  1051 <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="configuration.html#SEC_Top">Top</A>]</TD>
   742 <SAMP>`mailer-daemon'</SAMP>
  1052 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
  1053 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1054 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
  1055 </TR></TABLE>
       
  1056 <H2> 2.24 postmaster-aliases </H2>
       
  1057 <!--docid::SEC29::-->
       
  1058 <P>
       
  1059 
       
  1060 <DL COMPACT>
       
  1061 <DT><STRONG>Type</STRONG>
       
  1062 <DD>list
       
  1063 <DT><STRONG>Default</STRONG>
       
  1064 <DD><SAMP>`mailer-daemon'</SAMP>
   743 <SAMP>`postmaster'</SAMP>
  1065 <SAMP>`postmaster'</SAMP>
   744 <SAMP>`root'</SAMP>
  1066 <SAMP>`root'</SAMP>
   745 <DT><STRONG>Used By</STRONG>
  1067 <DT><STRONG>Used By</STRONG>
   746 <DD>
  1068 <DD>vsetup
   747 vsetup
  1069 <DT><STRONG>Description</STRONG>
   748 <DT><STRONG>Description</STRONG>
  1070 <DD>A list of aliases to the postmaster email address to set
   749 <DD>
       
   750 A list of aliases to the postmaster email address to set
       
   751 up when creating a new virtual domain with the vsetup command.
  1071 up when creating a new virtual domain with the vsetup command.
   752 This should <EM>always</EM> contain both <SAMP>`postmaster'</SAMP> and
  1072 This should <EM>always</EM> contain both <SAMP>`postmaster'</SAMP> and
   753 <SAMP>`mailer-daemon'</SAMP> (required by the RFCs), and should usually contain
  1073 <SAMP>`mailer-daemon'</SAMP> (required by the RFCs), and should usually contain
   754 <SAMP>`root'</SAMP>.
  1074 <SAMP>`root'</SAMP>.
   755 </DL>
  1075 </DL>
   756 
  1076 <P>
   757 
  1077 
   758 
  1078 <A NAME="postmaster-email"></A>
   759 <H2><A NAME="SEC30" HREF="configuration.html#TOC30">2.25 postmaster-email</A></H2>
  1079 <HR SIZE="6">
   760 
  1080 <A NAME="SEC30"></A>
   761 <DL COMPACT>
  1081 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   762 
  1082 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC29"> &lt; </A>]</TD>
   763 <DT><STRONG>Type</STRONG>
  1083 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC31"> &gt; </A>]</TD>
   764 <DD>
  1084 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   765 string
  1085 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   766 <DT><STRONG>Default</STRONG>
  1086 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   767 <DD>
  1087 <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="configuration.html#SEC_Top">Top</A>]</TD>
   768 <SAMP>`postmaster@'</SAMP>
  1088 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   769 <DT><STRONG>Used By</STRONG>
  1089 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   770 <DD>
  1090 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   771 vsetup
  1091 </TR></TABLE>
   772 <DT><STRONG>Description</STRONG>
  1092 <H2> 2.25 postmaster-email </H2>
   773 <DD>
  1093 <!--docid::SEC30::-->
   774 Identifies the email address of the entity responsible
  1094 <P>
       
  1095 
       
  1096 <DL COMPACT>
       
  1097 <DT><STRONG>Type</STRONG>
       
  1098 <DD>string
       
  1099 <DT><STRONG>Default</STRONG>
       
  1100 <DD><SAMP>`postmaster@'</SAMP>
       
  1101 <DT><STRONG>Used By</STRONG>
       
  1102 <DD>vsetup
       
  1103 <DT><STRONG>Description</STRONG>
       
  1104 <DD>Identifies the email address of the entity responsible
   775 for the administration of the (virtual) host when building the
  1105 for the administration of the (virtual) host when building the
   776 postmaster aliases above.
  1106 postmaster aliases above.
   777 If this value ends with a trailing <SAMP>`@'</SAMP>, the value of
  1107 If this value ends with a trailing <SAMP>`@'</SAMP>, the value of
   778 <TT>`/var/qmail/control/me'</TT> is filled in for the host name.
  1108 <TT>`/var/qmail/control/me'</TT> is filled in for the host name.
   779 If no <SAMP>`@'</SAMP> is present, the current virtual host name
  1109 If no <SAMP>`@'</SAMP> is present, the current virtual host name
   780 is filled in by vdeliver.
  1110 is filled in by vdeliver.
   781 If this is set to <SAMP>`postmaster'</SAMP>, a mail loop
  1111 If this is set to <SAMP>`postmaster'</SAMP>, a mail loop
   782 will result and all mail to this address will bounce.
  1112 will result and all mail to this address will bounce.
   783 </DL>
  1113 </DL>
   784 
  1114 <P>
   785 
  1115 
   786 
  1116 <A NAME="qmail-root"></A>
   787 <H2><A NAME="SEC31" HREF="configuration.html#TOC31">2.26 qmail-root</A></H2>
  1117 <HR SIZE="6">
   788 
  1118 <A NAME="SEC31"></A>
   789 <DL COMPACT>
  1119 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   790 
  1120 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC30"> &lt; </A>]</TD>
   791 <DT><STRONG>Type</STRONG>
  1121 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC32"> &gt; </A>]</TD>
   792 <DD>
  1122 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   793 string
  1123 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   794 <DT><STRONG>Default</STRONG>
  1124 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   795 <DD>
  1125 <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="configuration.html#SEC_Top">Top</A>]</TD>
   796 <SAMP>`/var/qmail'</SAMP>
  1126 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   797 <DT><STRONG>Used By</STRONG>
  1127 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   798 <DD>
  1128 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   799 checkvpw, vdeliver, vmailmgrd
  1129 </TR></TABLE>
   800 <DT><STRONG>Description</STRONG>
  1130 <H2> 2.26 qmail-root </H2>
   801 <DD>
  1131 <!--docid::SEC31::-->
   802 Specifies the location of the base directory of your qmail install.
  1132 <P>
       
  1133 
       
  1134 <DL COMPACT>
       
  1135 <DT><STRONG>Type</STRONG>
       
  1136 <DD>string
       
  1137 <DT><STRONG>Default</STRONG>
       
  1138 <DD><SAMP>`/var/qmail'</SAMP>
       
  1139 <DT><STRONG>Used By</STRONG>
       
  1140 <DD>checkvpw, vdeliver, vmailmgrd
       
  1141 <DT><STRONG>Description</STRONG>
       
  1142 <DD>Specifies the location of the base directory of your qmail install.
   803 Set this to whatever you put into <TT>`conf-home'</TT> when you built and
  1143 Set this to whatever you put into <TT>`conf-home'</TT> when you built and
   804 installed qmail.
  1144 installed qmail.
   805 </DL>
  1145 </DL>
   806 
  1146 <P>
   807 
  1147 
   808 
  1148 <A NAME="separators"></A>
   809 <H2><A NAME="SEC32" HREF="configuration.html#TOC32">2.27 separators</A></H2>
  1149 <HR SIZE="6">
   810 
  1150 <A NAME="SEC32"></A>
   811 <DL COMPACT>
  1151 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   812 
  1152 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC31"> &lt; </A>]</TD>
   813 <DT><STRONG>Type</STRONG>
  1153 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC33"> &gt; </A>]</TD>
   814 <DD>
  1154 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   815 string
  1155 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   816 <DT><STRONG>Default</STRONG>
  1156 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   817 <DD>
  1157 <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="configuration.html#SEC_Top">Top</A>]</TD>
   818 <SAMP>`@:'</SAMP>
  1158 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   819 <DT><STRONG>Used By</STRONG>
  1159 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   820 <DD>
  1160 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   821 checkvpw (global only)
  1161 </TR></TABLE>
   822 <DT><STRONG>Description</STRONG>
  1162 <H2> 2.27 separators </H2>
   823 <DD>
  1163 <!--docid::SEC32::-->
   824 Identifies the set of valid separators within a user login name between
  1164 <P>
       
  1165 
       
  1166 <DL COMPACT>
       
  1167 <DT><STRONG>Type</STRONG>
       
  1168 <DD>string
       
  1169 <DT><STRONG>Default</STRONG>
       
  1170 <DD><SAMP>`@:'</SAMP>
       
  1171 <DT><STRONG>Used By</STRONG>
       
  1172 <DD>checkvpw (global only)
       
  1173 <DT><STRONG>Description</STRONG>
       
  1174 <DD>Identifies the set of valid separators within a user login name between
   825 the virtual user name and virtual domain name when logging in via
  1175 the virtual user name and virtual domain name when logging in via
   826 checkvpw.
  1176 checkvpw.
   827 For example, if separators contains <SAMP>`@:'</SAMP> then <SAMP>`user@domain'</SAMP> and
  1177 For example, if separators contains <SAMP>`@:'</SAMP> then <SAMP>`user@domain'</SAMP> and
   828 <SAMP>`user:domain'</SAMP> are equivalent POP mailbox names.
  1178 <SAMP>`user:domain'</SAMP> are equivalent POP mailbox names.
   829 </DL>
  1179 </DL>
   830 
  1180 <P>
   831 
  1181 
   832 
  1182 <A NAME="socket-file"></A>
   833 <H2><A NAME="SEC33" HREF="configuration.html#TOC33">2.28 socket-file</A></H2>
  1183 <HR SIZE="6">
   834 
  1184 <A NAME="SEC33"></A>
   835 <DL COMPACT>
  1185 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   836 
  1186 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC32"> &lt; </A>]</TD>
   837 <DT><STRONG>Type</STRONG>
  1187 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC34"> &gt; </A>]</TD>
   838 <DD>
  1188 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   839 string
  1189 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   840 <DT><STRONG>Default</STRONG>
  1190 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   841 <DD>
  1191 <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="configuration.html#SEC_Top">Top</A>]</TD>
   842 <SAMP>`/tmp/.vmailmgrd'</SAMP>
  1192 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   843 <DT><STRONG>Used By</STRONG>
  1193 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   844 <DD>
  1194 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   845 vmailmgrd, checkvpw, vdeliver, and the CGI programs
  1195 </TR></TABLE>
   846 <DT><STRONG>Description</STRONG>
  1196 <H2> 2.28 socket-file </H2>
   847 <DD>
  1197 <!--docid::SEC33::-->
   848 Identifies the file name of the local socket used to
  1198 <P>
       
  1199 
       
  1200 <DL COMPACT>
       
  1201 <DT><STRONG>Type</STRONG>
       
  1202 <DD>string
       
  1203 <DT><STRONG>Default</STRONG>
       
  1204 <DD><SAMP>`/tmp/.vmailmgrd'</SAMP>
       
  1205 <DT><STRONG>Used By</STRONG>
       
  1206 <DD>vmailmgrd, checkvpw, vdeliver, and the CGI programs
       
  1207 <DT><STRONG>Description</STRONG>
       
  1208 <DD>Identifies the file name of the local socket used to
   849 communicate between the vmailmgr daemon and the other programs.
  1209 communicate between the vmailmgr daemon and the other programs.
   850 <EM>Warning:</EM> Changing this in the local configuration directories
  1210 <EM>Warning:</EM> Changing this in the local configuration directories
   851 will cause vdeliver to fail.
  1211 will cause vdeliver to fail.
   852 </DL>
  1212 </DL>
   853 
  1213 <P>
   854 
  1214 
   855 
  1215 <A NAME="user-dir"></A>
   856 <H2><A NAME="SEC34" HREF="configuration.html#TOC34">2.29 user-dir</A></H2>
  1216 <HR SIZE="6">
   857 
  1217 <A NAME="SEC34"></A>
   858 <DL COMPACT>
  1218 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   859 
  1219 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC33"> &lt; </A>]</TD>
   860 <DT><STRONG>Type</STRONG>
  1220 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC35"> &gt; </A>]</TD>
   861 <DD>
  1221 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   862 directory
  1222 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   863 <DT><STRONG>Default</STRONG>
  1223 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   864 <DD>
  1224 <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="configuration.html#SEC_Top">Top</A>]</TD>
   865 <SAMP>`users'</SAMP>
  1225 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   866 <DT><STRONG>Used By</STRONG>
  1226 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   867 <DD>
  1227 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   868 vmailmgrd and command-line programs
  1228 </TR></TABLE>
   869 <DT><STRONG>Description</STRONG>
  1229 <H2> 2.29 user-dir </H2>
   870 <DD>
  1230 <!--docid::SEC34::-->
   871 Identifies the subdirectory from the virtual domain directory in which a
  1231 <P>
       
  1232 
       
  1233 <DL COMPACT>
       
  1234 <DT><STRONG>Type</STRONG>
       
  1235 <DD>directory
       
  1236 <DT><STRONG>Default</STRONG>
       
  1237 <DD><SAMP>`users'</SAMP>
       
  1238 <DT><STRONG>Used By</STRONG>
       
  1239 <DD>vmailmgrd and command-line programs
       
  1240 <DT><STRONG>Description</STRONG>
       
  1241 <DD>Identifies the subdirectory from the virtual domain directory in which a
   872 virtual user's maildir will be created.
  1242 virtual user's maildir will be created.
   873 Since this maildir is recorded in the password table, it does not have
  1243 Since this maildir is recorded in the password table, it does not have
   874 to be the same for each user within a domain.
  1244 to be the same for each user within a domain.
   875 This is prefixed with <SAMP>`./'</SAMP> before it is used in the password table.
  1245 This is prefixed with <SAMP>`./'</SAMP> before it is used in the password table.
   876 </DL>
  1246 </DL>
   877 
  1247 <P>
   878 
  1248 
   879 
  1249 <A NAME="user-dir-bits"></A>
   880 <H2><A NAME="SEC35" HREF="configuration.html#TOC35">2.30 user-dir-bits</A></H2>
  1250 <HR SIZE="6">
   881 
  1251 <A NAME="SEC35"></A>
   882 <DL COMPACT>
  1252 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   883 
  1253 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC34"> &lt; </A>]</TD>
   884 <DT><STRONG>Type</STRONG>
  1254 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC36"> &gt; </A>]</TD>
   885 <DD>
  1255 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   886 <DT><STRONG>Default</STRONG>
  1256 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   887 <DD>
  1257 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   888 <SAMP>`0'</SAMP>
  1258 <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="configuration.html#SEC_Top">Top</A>]</TD>
   889 <DT><STRONG>Used By</STRONG>
  1259 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   890 <DD>
  1260 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   891 vmailmgrd and command-line programs when creating new users.
  1261 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   892 <DT><STRONG>Description</STRONG>
  1262 </TR></TABLE>
   893 <DD>
  1263 <H2> 2.30 user-dir-bits </H2>
   894 See section <A HREF="configuration.html#SEC36">2.31 user-dir-slices</A>
  1264 <!--docid::SEC35::-->
   895 </DL>
  1265 <P>
   896 
  1266 
   897 
  1267 <DL COMPACT>
   898 
  1268 <DT><STRONG>Type</STRONG>
   899 <H2><A NAME="SEC36" HREF="configuration.html#TOC36">2.31 user-dir-slices</A></H2>
  1269 <DD><DT><STRONG>Default</STRONG>
   900 
  1270 <DD><SAMP>`0'</SAMP>
   901 <DL COMPACT>
  1271 <DT><STRONG>Used By</STRONG>
   902 
  1272 <DD>vmailmgrd and command-line programs when creating new users.
   903 <DT><STRONG>Type</STRONG>
  1273 <DT><STRONG>Description</STRONG>
   904 <DD>
  1274 <DD>See section <A HREF="configuration.html#SEC36">2.31 user-dir-slices</A>.
   905 <DT><STRONG>Default</STRONG>
  1275 </DL>
   906 <DD>
  1276 <P>
   907 <SAMP>`0'</SAMP>
  1277 
   908 <DT><STRONG>Used By</STRONG>
  1278 <A NAME="user-dir-slices"></A>
   909 <DD>
  1279 <HR SIZE="6">
   910 vmailmgrd and command-line programs when creating new users.
  1280 <A NAME="SEC36"></A>
   911 <DT><STRONG>Description</STRONG>
  1281 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   912 <DD>
  1282 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC35"> &lt; </A>]</TD>
   913 <TT>`user-dir-bits'</TT> and <TT>`user-dir-slices'</TT> work together.  When creating a
  1283 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC37"> &gt; </A>]</TD>
       
  1284 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
       
  1285 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
       
  1286 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
       
  1287 <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="configuration.html#SEC_Top">Top</A>]</TD>
       
  1288 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
  1289 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1290 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
  1291 </TR></TABLE>
       
  1292 <H2> 2.31 user-dir-slices </H2>
       
  1293 <!--docid::SEC36::-->
       
  1294 <P>
       
  1295 
       
  1296 <DL COMPACT>
       
  1297 <DT><STRONG>Type</STRONG>
       
  1298 <DD><DT><STRONG>Default</STRONG>
       
  1299 <DD><SAMP>`0'</SAMP>
       
  1300 <DT><STRONG>Used By</STRONG>
       
  1301 <DD>vmailmgrd and command-line programs when creating new users.
       
  1302 <DT><STRONG>Description</STRONG>
       
  1303 <DD><TT>`user-dir-bits'</TT> and <TT>`user-dir-slices'</TT> work together.  When creating a
   914 new user directory name, a hash code is generated on the name of the
  1304 new user directory name, a hash code is generated on the name of the
   915 new user.  This hash code is split into <TT>`user-dir-slices'</TT> pieces, each
  1305 new user.  This hash code is split into <TT>`user-dir-slices'</TT> pieces, each
   916 <TT>`user-dir-bits'</TT> bits long.  Each of these pieces is translated to an
  1306 <TT>`user-dir-bits'</TT> bits long.  Each of these pieces is translated to an
   917 ASCII string by converting the binary code to hexadecimal.  The
  1307 ASCII string by converting the binary code to hexadecimal.  The
   918 resulting user directory name is then composed of:
  1308 resulting user directory name is then composed of:
   919 
       
   920 <UL>
  1309 <UL>
   921 <LI>the base users directory, followed by a <SAMP>`/'</SAMP>
  1310 <LI>the base users directory, followed by a <SAMP>`/'</SAMP>
   922 
       
   923 <LI>each of the string pieces, each followed by a <SAMP>`/'</SAMP>
  1311 <LI>each of the string pieces, each followed by a <SAMP>`/'</SAMP>
   924 
       
   925 <LI>the user's name
  1312 <LI>the user's name
   926 
       
   927 </UL>
  1313 </UL>
   928 
       
   929 For example, with <TT>`user-dir-bits'</TT> set to 6 and
  1314 For example, with <TT>`user-dir-bits'</TT> set to 6 and
   930 <TT>`user-dir-slices'</TT> set to 1, a user
  1315 <TT>`user-dir-slices'</TT> set to 1, a user
   931 named <SAMP>`c'</SAMP> maps to a directory name of <SAMP>`users/2f/c/'</SAMP>.
  1316 named <SAMP>`c'</SAMP> maps to a directory name of <SAMP>`users/2f/c/'</SAMP>.
   932 </DL>
  1317 </DL>
   933 
  1318 <P>
   934 
  1319 
   935 
  1320 <A NAME="vdeliver-postdeliver"></A>
   936 <H2><A NAME="SEC37" HREF="configuration.html#TOC37">2.32 vdeliver-postdeliver</A></H2>
  1321 <HR SIZE="6">
   937 
  1322 <A NAME="SEC37"></A>
   938 <DL COMPACT>
  1323 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   939 
  1324 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC36"> &lt; </A>]</TD>
   940 <DT><STRONG>Type</STRONG>
  1325 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC38"> &gt; </A>]</TD>
   941 <DD>
  1326 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   942 executable
  1327 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   943 <DT><STRONG>Default</STRONG>
  1328 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   944 <DD>
  1329 <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="configuration.html#SEC_Top">Top</A>]</TD>
   945 Empty
  1330 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   946 <DT><STRONG>Used By</STRONG>
  1331 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   947 <DD>
  1332 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   948 vdeliver
  1333 </TR></TABLE>
   949 <DT><STRONG>Description</STRONG>
  1334 <H2> 2.32 vdeliver-postdeliver </H2>
   950 <DD>
  1335 <!--docid::SEC37::-->
   951 This list is executed after the delivery is successfully
  1336 <P>
       
  1337 
       
  1338 <DL COMPACT>
       
  1339 <DT><STRONG>Type</STRONG>
       
  1340 <DD>executable
       
  1341 <DT><STRONG>Default</STRONG>
       
  1342 <DD>Empty
       
  1343 <DT><STRONG>Used By</STRONG>
       
  1344 <DD>vdeliver
       
  1345 <DT><STRONG>Description</STRONG>
       
  1346 <DD>This list is executed after the delivery is successfully
   952 completed.
  1347 completed.
   953 Since vdeliver expects <SAMP>`USER'</SAMP> and <SAMP>`HOME'</SAMP> to be set, it does
  1348 Since vdeliver expects <SAMP>`USER'</SAMP> and <SAMP>`HOME'</SAMP> to be set, it does
   954 not set them itself.
  1349 not set them itself.
   955 If the command returns with an error code, a warning is printed, but
  1350 If the command returns with an error code, a warning is printed, but
   956 delivery does not fail, as failure would lead to duplicates.
  1351 delivery does not fail, as failure would lead to duplicates.
   957 </DL>
  1352 </DL>
   958 
  1353 <P>
   959 
  1354 
   960 
  1355 <A NAME="vdeliver-predeliver"></A>
   961 <H2><A NAME="SEC38" HREF="configuration.html#TOC38">2.33 vdeliver-predeliver</A></H2>
  1356 <HR SIZE="6">
   962 
  1357 <A NAME="SEC38"></A>
   963 <DL COMPACT>
  1358 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   964 
  1359 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC37"> &lt; </A>]</TD>
   965 <DT><STRONG>Type</STRONG>
  1360 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC39"> &gt; </A>]</TD>
   966 <DD>
  1361 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   967 executable
  1362 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   968 <DT><STRONG>Default</STRONG>
  1363 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   969 <DD>
  1364 <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="configuration.html#SEC_Top">Top</A>]</TD>
   970 Empty
  1365 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   971 <DT><STRONG>Used By</STRONG>
  1366 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   972 <DD>
  1367 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   973 vdeliver
  1368 </TR></TABLE>
   974 <DT><STRONG>Description</STRONG>
  1369 <H2> 2.33 vdeliver-predeliver </H2>
   975 <DD>
  1370 <!--docid::SEC38::-->
   976 This list is executed before the delivery is attempted, but
  1371 <P>
       
  1372 
       
  1373 <DL COMPACT>
       
  1374 <DT><STRONG>Type</STRONG>
       
  1375 <DD>executable
       
  1376 <DT><STRONG>Default</STRONG>
       
  1377 <DD>Empty
       
  1378 <DT><STRONG>Used By</STRONG>
       
  1379 <DD>vdeliver
       
  1380 <DT><STRONG>Description</STRONG>
       
  1381 <DD>This list is executed before the delivery is attempted, but
   977 after the virtual user information is looked up.
  1382 after the virtual user information is looked up.
   978 Since vdeliver expects <SAMP>`USER'</SAMP> and <SAMP>`HOME'</SAMP> to be set, it does
  1383 Since vdeliver expects <SAMP>`USER'</SAMP> and <SAMP>`HOME'</SAMP> to be set, it does
   979 not set them itself.
  1384 not set them itself.
   980 </DL>
  1385 </DL>
   981 
  1386 <P>
   982 
  1387 
   983 
  1388 <A NAME="vsetup-post"></A>
   984 <H2><A NAME="SEC39" HREF="configuration.html#TOC39">2.34 vsetup-pre</A></H2>
  1389 <HR SIZE="6">
   985 
  1390 <A NAME="SEC39"></A>
   986 <DL COMPACT>
  1391 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
   987 
  1392 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC38"> &lt; </A>]</TD>
   988 <DT><STRONG>Type</STRONG>
  1393 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC40"> &gt; </A>]</TD>
   989 <DD>
  1394 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
   990 executable
  1395 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
   991 <DT><STRONG>Default</STRONG>
  1396 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
   992 <DD>
  1397 <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="configuration.html#SEC_Top">Top</A>]</TD>
   993 Empty
  1398 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
   994 <DT><STRONG>Used By</STRONG>
  1399 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
   995 <DD>
  1400 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
   996 vsetup
  1401 </TR></TABLE>
   997 <DT><STRONG>Description</STRONG>
  1402 <H2> 2.34 vsetup-post </H2>
   998 <DD>
  1403 <!--docid::SEC39::-->
   999 This list is executed after the vsetup command has sucessfully done
  1404 <P>
       
  1405 
       
  1406 <DL COMPACT>
       
  1407 <DT><STRONG>Type</STRONG>
       
  1408 <DD>executable
       
  1409 <DT><STRONG>Default</STRONG>
       
  1410 <DD>Empty
       
  1411 <DT><STRONG>Used By</STRONG>
       
  1412 <DD>vsetup
       
  1413 <DT><STRONG>Description</STRONG>
       
  1414 <DD>This list is executed after the vsetup command has sucessfully done
  1000 everything else.
  1415 everything else.
  1001 </DL>
  1416 </DL>
  1002 
  1417 <P>
  1003 
  1418 
  1004 
  1419 <A NAME="vsetup-pre"></A>
  1005 <H2><A NAME="SEC40" HREF="configuration.html#TOC40">2.35 vsetup-pre</A></H2>
  1420 <HR SIZE="6">
  1006 
  1421 <A NAME="SEC40"></A>
  1007 <DL COMPACT>
  1422 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
  1008 
  1423 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC39"> &lt; </A>]</TD>
  1009 <DT><STRONG>Type</STRONG>
  1424 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
  1010 <DD>
  1425 <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> &lt;&lt; </A>]</TD>
  1011 executable
  1426 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC5"> Up </A>]</TD>
  1012 <DT><STRONG>Default</STRONG>
  1427 <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
  1013 <DD>
  1428 <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="configuration.html#SEC_Top">Top</A>]</TD>
  1014 Empty
  1429 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
  1015 <DT><STRONG>Used By</STRONG>
  1430 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
  1016 <DD>
  1431 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
  1017 vsetup
  1432 </TR></TABLE>
  1018 <DT><STRONG>Description</STRONG>
  1433 <H2> 2.35 vsetup-pre </H2>
  1019 <DD>
  1434 <!--docid::SEC40::-->
  1020 This list is executed before the vsetup command makes any changes.
  1435 <P>
  1021 </DL>
  1436 
  1022 
  1437 <DL COMPACT>
  1023 <P><HR><P>
  1438 <DT><STRONG>Type</STRONG>
  1024 This document was generated on 14 September 2000 using
  1439 <DD>executable
  1025 <A HREF="http://wwwinfo.cern.ch/dis/texi2html/">texi2html</A>&nbsp;1.56k.
  1440 <DT><STRONG>Default</STRONG>
       
  1441 <DD>Empty
       
  1442 <DT><STRONG>Used By</STRONG>
       
  1443 <DD>vsetup
       
  1444 <DT><STRONG>Description</STRONG>
       
  1445 <DD>This list is executed before the vsetup command makes any changes.
       
  1446 </DL>
       
  1447 <P>
       
  1448 
       
  1449 <HR SIZE="6">
       
  1450 <A NAME="SEC_Contents"></A>
       
  1451 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
  1452 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top">Top</A>]</TD>
       
  1453 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
  1454 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1455 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
  1456 </TR></TABLE>
       
  1457 <H1>Table of Contents</H1>
       
  1458 <UL>
       
  1459 <A NAME="TOC1" HREF="configuration.html#SEC1">1. General Information</A>
       
  1460 <BR>
       
  1461 <UL>
       
  1462 <A NAME="TOC2" HREF="configuration.html#SEC2">1.1 Search Order</A>
       
  1463 <BR>
       
  1464 <A NAME="TOC3" HREF="configuration.html#SEC3">1.2 File Types</A>
       
  1465 <BR>
       
  1466 <A NAME="TOC4" HREF="configuration.html#SEC4">1.3 Command Execution</A>
       
  1467 <BR>
       
  1468 </UL>
       
  1469 <A NAME="TOC5" HREF="configuration.html#SEC5">2. Configuration Files</A>
       
  1470 <BR>
       
  1471 <UL>
       
  1472 <A NAME="TOC6" HREF="configuration.html#SEC6">2.1 authvmailmgr-error</A>
       
  1473 <BR>
       
  1474 <A NAME="TOC7" HREF="configuration.html#SEC7">2.2 authvmailmgr-loginfail</A>
       
  1475 <BR>
       
  1476 <A NAME="TOC8" HREF="configuration.html#SEC8">2.3 authvmailmgr-postsetuid</A>
       
  1477 <BR>
       
  1478 <A NAME="TOC9" HREF="configuration.html#SEC9">2.4 authvmailmgr-presetuid</A>
       
  1479 <BR>
       
  1480 <A NAME="TOC10" HREF="configuration.html#SEC10">2.5 autoresponse-dir</A>
       
  1481 <BR>
       
  1482 <A NAME="TOC11" HREF="configuration.html#SEC11">2.6 autoresponse-file</A>
       
  1483 <BR>
       
  1484 <A NAME="TOC12" HREF="configuration.html#SEC12">2.7 bulletin-dir</A>
       
  1485 <BR>
       
  1486 <A NAME="TOC13" HREF="configuration.html#SEC13">2.8 checkvpw-error</A>
       
  1487 <BR>
       
  1488 <A NAME="TOC14" HREF="configuration.html#SEC14">2.9 checkvpw-loginfail</A>
       
  1489 <BR>
       
  1490 <A NAME="TOC15" HREF="configuration.html#SEC15">2.10 checkvpw-postexec</A>
       
  1491 <BR>
       
  1492 <A NAME="TOC16" HREF="configuration.html#SEC16">2.11 checkvpw-postsetuid</A>
       
  1493 <BR>
       
  1494 <A NAME="TOC17" HREF="configuration.html#SEC17">2.12 checkvpw-presetuid</A>
       
  1495 <BR>
       
  1496 <A NAME="TOC18" HREF="configuration.html#SEC18">2.13 default-expiry</A>
       
  1497 <BR>
       
  1498 <A NAME="TOC19" HREF="configuration.html#SEC19">2.14 default-maildir</A>
       
  1499 <BR>
       
  1500 <A NAME="TOC20" HREF="configuration.html#SEC20">2.15 default-msgcount</A>
       
  1501 <BR>
       
  1502 <A NAME="TOC21" HREF="configuration.html#SEC21">2.16 default-msgsize</A>
       
  1503 <BR>
       
  1504 <A NAME="TOC22" HREF="configuration.html#SEC22">2.17 default-hardquota</A>
       
  1505 <BR>
       
  1506 <A NAME="TOC23" HREF="configuration.html#SEC23">2.18 default-softquota</A>
       
  1507 <BR>
       
  1508 <A NAME="TOC24" HREF="configuration.html#SEC24">2.19 default-username</A>
       
  1509 <BR>
       
  1510 <A NAME="TOC25" HREF="configuration.html#SEC25">2.20 error-maildir</A>
       
  1511 <BR>
       
  1512 <A NAME="TOC26" HREF="configuration.html#SEC26">2.21 global-bulletin-dir</A>
       
  1513 <BR>
       
  1514 <A NAME="TOC27" HREF="configuration.html#SEC27">2.22 maildir-arg-str</A>
       
  1515 <BR>
       
  1516 <A NAME="TOC28" HREF="configuration.html#SEC28">2.23 password-file</A>
       
  1517 <BR>
       
  1518 <A NAME="TOC29" HREF="configuration.html#SEC29">2.24 postmaster-aliases</A>
       
  1519 <BR>
       
  1520 <A NAME="TOC30" HREF="configuration.html#SEC30">2.25 postmaster-email</A>
       
  1521 <BR>
       
  1522 <A NAME="TOC31" HREF="configuration.html#SEC31">2.26 qmail-root</A>
       
  1523 <BR>
       
  1524 <A NAME="TOC32" HREF="configuration.html#SEC32">2.27 separators</A>
       
  1525 <BR>
       
  1526 <A NAME="TOC33" HREF="configuration.html#SEC33">2.28 socket-file</A>
       
  1527 <BR>
       
  1528 <A NAME="TOC34" HREF="configuration.html#SEC34">2.29 user-dir</A>
       
  1529 <BR>
       
  1530 <A NAME="TOC35" HREF="configuration.html#SEC35">2.30 user-dir-bits</A>
       
  1531 <BR>
       
  1532 <A NAME="TOC36" HREF="configuration.html#SEC36">2.31 user-dir-slices</A>
       
  1533 <BR>
       
  1534 <A NAME="TOC37" HREF="configuration.html#SEC37">2.32 vdeliver-postdeliver</A>
       
  1535 <BR>
       
  1536 <A NAME="TOC38" HREF="configuration.html#SEC38">2.33 vdeliver-predeliver</A>
       
  1537 <BR>
       
  1538 <A NAME="TOC39" HREF="configuration.html#SEC39">2.34 vsetup-post</A>
       
  1539 <BR>
       
  1540 <A NAME="TOC40" HREF="configuration.html#SEC40">2.35 vsetup-pre</A>
       
  1541 <BR>
       
  1542 </UL>
       
  1543 </UL>
       
  1544 <HR SIZE=1>
       
  1545 <A NAME="SEC_OVERVIEW"></A>
       
  1546 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
  1547 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top">Top</A>]</TD>
       
  1548 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
  1549 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1550 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
  1551 </TR></TABLE>
       
  1552 <H1>Short Table of Contents</H1>
       
  1553 <BLOCKQUOTE>
       
  1554 <A NAME="TOC1" HREF="configuration.html#SEC1">1. General Information</A>
       
  1555 <BR>
       
  1556 <A NAME="TOC5" HREF="configuration.html#SEC5">2. Configuration Files</A>
       
  1557 <BR>
       
  1558 
       
  1559 </BLOCKQUOTE>
       
  1560 <HR SIZE=1>
       
  1561 <A NAME="SEC_About"></A>
       
  1562 <TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
       
  1563 <TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Top">Top</A>]</TD>
       
  1564 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_Contents">Contents</A>]</TD>
       
  1565 <TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
       
  1566 <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="configuration.html#SEC_About"> ? </A>]</TD>
       
  1567 </TR></TABLE>
       
  1568 <H1>About this document</H1>
       
  1569 This document was generated by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
       
  1570 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
       
  1571 "><I>texi2html</I></A>
       
  1572 <P></P>  
       
  1573 The buttons in the navigation panels have the following meaning:
       
  1574 <P></P>
       
  1575 <table border = "1">
       
  1576 <TR>
       
  1577 <TH> Button </TH>
       
  1578 <TH> Name </TH>
       
  1579 <TH> Go to </TH>
       
  1580 <TH> From 1.2.3 go to</TH>
       
  1581 </TR>
       
  1582 <TR>
       
  1583 <TD ALIGN="CENTER">
       
  1584  [ &lt; ] </TD>
       
  1585 <TD ALIGN="CENTER">
       
  1586 Back
       
  1587 </TD>
       
  1588 <TD>
       
  1589 previous section in reading order
       
  1590 </TD>
       
  1591 <TD>
       
  1592 1.2.2
       
  1593 </TD>
       
  1594 </TR>
       
  1595 <TR>
       
  1596 <TD ALIGN="CENTER">
       
  1597  [ &gt; ] </TD>
       
  1598 <TD ALIGN="CENTER">
       
  1599 Forward
       
  1600 </TD>
       
  1601 <TD>
       
  1602 next section in reading order
       
  1603 </TD>
       
  1604 <TD>
       
  1605 1.2.4
       
  1606 </TD>
       
  1607 </TR>
       
  1608 <TR>
       
  1609 <TD ALIGN="CENTER">
       
  1610  [ &lt;&lt; ] </TD>
       
  1611 <TD ALIGN="CENTER">
       
  1612 FastBack
       
  1613 </TD>
       
  1614 <TD>
       
  1615 previous or up-and-previous section 
       
  1616 </TD>
       
  1617 <TD>
       
  1618 1.1
       
  1619 </TD>
       
  1620 </TR>
       
  1621 <TR>
       
  1622 <TD ALIGN="CENTER">
       
  1623  [ Up ] </TD>
       
  1624 <TD ALIGN="CENTER">
       
  1625 Up
       
  1626 </TD>
       
  1627 <TD>
       
  1628 up section
       
  1629 </TD>
       
  1630 <TD>
       
  1631 1.2
       
  1632 </TD>
       
  1633 </TR>
       
  1634 <TR>
       
  1635 <TD ALIGN="CENTER">
       
  1636  [ &gt;&gt; ] </TD>
       
  1637 <TD ALIGN="CENTER">
       
  1638 FastForward
       
  1639 </TD>
       
  1640 <TD>
       
  1641 next or up-and-next section
       
  1642 </TD>
       
  1643 <TD>
       
  1644 1.3
       
  1645 </TD>
       
  1646 </TR>
       
  1647 <TR>
       
  1648 <TD ALIGN="CENTER">
       
  1649  [Top] </TD>
       
  1650 <TD ALIGN="CENTER">
       
  1651 Top
       
  1652 </TD>
       
  1653 <TD>
       
  1654 cover (top) of document
       
  1655 </TD>
       
  1656 <TD>
       
  1657  &nbsp; 
       
  1658 </TD>
       
  1659 </TR>
       
  1660 <TR>
       
  1661 <TD ALIGN="CENTER">
       
  1662  [Contents] </TD>
       
  1663 <TD ALIGN="CENTER">
       
  1664 Contents
       
  1665 </TD>
       
  1666 <TD>
       
  1667 table of contents
       
  1668 </TD>
       
  1669 <TD>
       
  1670  &nbsp; 
       
  1671 </TD>
       
  1672 </TR>
       
  1673 <TR>
       
  1674 <TD ALIGN="CENTER">
       
  1675  [Index] </TD>
       
  1676 <TD ALIGN="CENTER">
       
  1677 Index
       
  1678 </TD>
       
  1679 <TD>
       
  1680 concept index
       
  1681 </TD>
       
  1682 <TD>
       
  1683  &nbsp; 
       
  1684 </TD>
       
  1685 </TR>
       
  1686 <TR>
       
  1687 <TD ALIGN="CENTER">
       
  1688  [ ? ] </TD>
       
  1689 <TD ALIGN="CENTER">
       
  1690 About
       
  1691 </TD>
       
  1692 <TD>
       
  1693 this page
       
  1694 </TD>
       
  1695 <TD>
       
  1696  &nbsp; 
       
  1697 </TD>
       
  1698 </TR>
       
  1699 </TABLE>
       
  1700 <P></P>
       
  1701 where the <STRONG> Example </STRONG> assumes that the current position 
       
  1702 is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of 
       
  1703 the following structure:
       
  1704 <UL>
       
  1705 <LI> 1. Section One  </LI>
       
  1706 <UL>
       
  1707 <LI>1.1 Subsection One-One</LI>
       
  1708 <UL>
       
  1709 <LI> ... </LI>
       
  1710 </UL>
       
  1711 <LI>1.2 Subsection One-Two</LI>
       
  1712 <UL>
       
  1713 <LI>1.2.1 Subsubsection One-Two-One
       
  1714 </LI><LI>1.2.2 Subsubsection One-Two-Two
       
  1715 </LI><LI>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp; <STRONG>
       
  1716 &lt;== Current Position </STRONG>
       
  1717 </LI><LI>1.2.4 Subsubsection One-Two-Four
       
  1718 </LI></UL>
       
  1719 <LI>1.3 Subsection One-Three</LI>
       
  1720 <UL>
       
  1721 <LI> ... </LI>
       
  1722 </UL>
       
  1723 <LI>1.4 Subsection One-Four</LI>
       
  1724 </UL>
       
  1725 </UL>
       
  1726 
       
  1727 <HR SIZE=1>
       
  1728 <BR>  
       
  1729 <FONT SIZE="-1">
       
  1730 This document was generated
       
  1731 by <I>Bruce.Guenter.dyndns.org</I> on <I>December, 29  2004</I>
       
  1732 using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
       
  1733 "><I>texi2html</I></A>
       
  1734 
  1026 </BODY>
  1735 </BODY>
  1027 </HTML>
  1736 </HTML>