Changeset 7a20758


Ignore:
Timestamp:
05/17/2005 05:47:17 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
0bf9baf
Parents:
1e000922
Message:

Tagged courier.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4328 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/mail/courier.xml

    r1e000922 r7a20758  
    55  %general-entities;
    66
    7 <!ENTITY courier-download-http "http://prdownloads.sourceforge.net/courier/courier-&courier-version;.tar.bz2">
    8 <!ENTITY courier-download-ftp " ">
    9 <!ENTITY courier-md5sum "639bb3b236914e3b86f287ce3f55264e">
    10 <!ENTITY courier-size "4.3 MB">
    11 <!ENTITY courier-buildsize "102 MB">
    12 <!ENTITY courier-time "2.62 SBU">
     7  <!ENTITY courier-download-http "http://prdownloads.sourceforge.net/courier/courier-&courier-version;.tar.bz2">
     8  <!ENTITY courier-download-ftp " ">
     9  <!ENTITY courier-md5sum "639bb3b236914e3b86f287ce3f55264e">
     10  <!ENTITY courier-size "4.3 MB">
     11  <!ENTITY courier-buildsize "102 MB">
     12  <!ENTITY courier-time "2.62 SBU">
    1313]>
    1414
    1515<sect1 id="courier" xreflabel="Courier-&courier-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="courier.html"?>
    21 <title>Courier-&courier-version;</title>
    22 <indexterm zone="courier">
    23 <primary sortas="a-Courier">Courier MTA</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Courier</application></title>
    27 
    28 <para>The <application>Courier</application> package contains a Mail Transport
    29 Agent (<acronym>MTA</acronym>). This is useful for sending email to other users
    30 of your host machine. It can also be configured to be a central mail server for
    31 your domain or a mail relay agent. The <application>Courier</application>
    32 packages also includes a web-based email interface, <acronym>IMAP</acronym>,
    33 <acronym>IMAP</acronym>-<acronym>SSL</acronym>, <acronym>POP</acronym>3, and
    34 <acronym>POP</acronym>3-<acronym>SSL</acronym>.</para>
    35 
    36 <sect3><title>Package information</title>
    37 <itemizedlist spacing='compact'>
    38 <listitem><para>Download (HTTP):
    39 <ulink url="&courier-download-http;"/></para></listitem>
    40 <listitem><para>Download (FTP):
    41 <ulink url="&courier-download-ftp;"/></para></listitem>
    42 <listitem><para>Download MD5 sum: &courier-md5sum;</para></listitem>
    43 <listitem><para>Download size: &courier-size;</para></listitem>
    44 <listitem><para>Estimated disk space required:
    45 &courier-buildsize;</para></listitem>
    46 <listitem><para>Estimated build time:
    47 &courier-time;</para></listitem></itemizedlist>
    48 </sect3>
    49 
    50 <sect3><title><application>Courier</application> dependencies</title>
    51 <sect4><title>Required</title>
    52 <para><xref linkend="gdbm"/></para>
    53 </sect4>
    54 
    55 <sect4><title>Optional</title>
    56 <para><xref linkend="mysql"/> or <xref linkend="postgresql"/>,
    57 <xref linkend="Linux_PAM"/>,
    58 <xref linkend="openssl"/>,
    59 <xref linkend="fam"/>,
    60 <xref linkend="openldap"/>,
    61 <xref linkend="apache"/>,
    62 <xref linkend="ispell"/> or <xref linkend="aspell"/>,
    63 <xref linkend="gnupg"/>,
    64 <xref linkend="expect"/>,
    65 <xref linkend="gs"/> or <xref linkend="espgs"/>,
    66 <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink> and
    67 <ulink url="http://alpha.greenie.net/mgetty/">Mgetty+Sendfax</ulink></para>
    68 </sect4>
    69 </sect3>
    70 
    71 </sect2>
    72 
    73 <sect2>
    74 <title>Installation of <application>Courier</application></title>
    75 <note><para><application>Courier's</application> tarball must be extacted as an
    76 unprivileged user or the configure script will fail.</para></note>
    77  
    78 <para>Before you compile the program, you need to create the courier user
    79 and group that is expected to be in place when the install script executes.
    80 As the root user, add the courier user and group with the following
    81 commands:</para>
    82 
    83 <screen><userinput role="root"><command>groupadd courier &amp;&amp;
     16  <?dbhtml filename="courier.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Courier-&courier-version;</title>
     24
     25  <indexterm zone="courier">
     26    <primary sortas="a-Courier">Courier MTA</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Courier</title>
     31
     32    <para>The <application>Courier</application> package contains a Mail
     33    Transport Agent (MTA). This is useful for sending email to other users
     34    of your host machine. It can also be configured to be a central mail
     35    server for your domain or a mail relay agent. The
     36    <application>Courier</application> packages also includes a web-based
     37    email interface, IMAP, IMAP-SSL, POP3, and POP3-SSL.</para>
     38
     39    <bridgehead renderas="sect3">Package Information</bridgehead>
     40    <itemizedlist spacing="compact">
     41      <listitem>
     42        <para>Download (HTTP): <ulink url="&courier-download-http;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download (FTP): <ulink url="&courier-download-ftp;"/></para>
     46      </listitem>
     47      <listitem>
     48        <para>Download MD5 sum: &courier-md5sum;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Download size: &courier-size;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated disk space required: &courier-buildsize;</para>
     55      </listitem>
     56      <listitem>
     57        <para>Estimated build time: &courier-time;</para>
     58      </listitem>
     59    </itemizedlist>
     60
     61    <bridgehead renderas="sect3">Courier Dependencies</bridgehead>
     62
     63    <bridgehead renderas="sect4">Required</bridgehead>
     64    <para><xref linkend="gdbm"/></para>
     65
     66    <bridgehead renderas="sect4">Optional</bridgehead>
     67    <para><xref linkend="mysql"/> or <xref linkend="postgresql"/>,
     68    <xref linkend="Linux_PAM"/>,
     69    <xref linkend="openssl"/>,
     70    <xref linkend="fam"/>,
     71    <xref linkend="openldap"/>,
     72    <xref linkend="apache"/>,
     73    <xref linkend="ispell"/> or <xref linkend="aspell"/>,
     74    <xref linkend="gnupg"/>,
     75    <xref linkend="expect"/>,
     76    <xref linkend="gs"/> or <xref linkend="espgs"/>,
     77    <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink> and
     78    <ulink url="http://alpha.greenie.net/mgetty/">Mgetty+Sendfax</ulink></para>
     79
     80  </sect2>
     81
     82  <sect2 role="installation">
     83    <title>Installation of Courier</title>
     84
     85    <note>
     86      <para><application>Courier</application>'s tarball must be extacted
     87      as an unprivileged user or the configure script will fail.</para>
     88    </note>
     89
     90    <para>Before you compile the program, you need to create the
     91    <systemitem class="username">courier</systemitem> user and group
     92    that is expected to be in place when the install script executes.
     93    As the <systemitem class="username">root</systemitem> user, add
     94    the <systemitem class="username">courier</systemitem> user and
     95    group with the following commands:</para>
     96
     97<screen role="root"><userinput>groupadd courier &amp;&amp;
    8498useradd -c 'Courier Mail Server' -d /dev/null \
    85         -g courier -s /bin/false courier</command></userinput></screen>
    86 
    87 <para>The install script also expects a bin user. If you already have a user
    88 named bin, this step can be safely ignored.</para>
    89 
    90 <screen><userinput role="root"><command>useradd -c 'bin' -d /dev/null -g bin -u 1 bin</command></userinput></screen>
    91 
    92 <para><application>Courierfilter</application> requires the directory
    93 <filename class="directory">/var/run/courier</filename> to store
    94 all the <application>Courier</application> pid and lockfiles. 
    95 <filename class="directory">/var/lock/subsys</filename> also must exist
    96 for the master lock file for <application>Courier</application>. Issue
    97 the following commands to create these directories:</para>
    98 
    99 <screen><userinput role="root"><command>install -d /var/run/courier -o courier -g courier -m755 &amp;&amp;
    100 install -d /var/lock/subsys -o root -g root -m755</command></userinput></screen>
    101 
    102 <para>Build <application>Courier</application> as an unprivileged user
    103 with the following commands:</para>
    104 
    105 <screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib/courier \
     99        -g courier -s /bin/false courier</userinput></screen>
     100
     101    <para>The install script also expects a <systemitem
     102    class="username">bin</systemitem> user. If you already have a
     103    user named <systemitem class="username">bin</systemitem>, this
     104    step can be safely ignored.</para>
     105
     106<screen role="root"><userinput>useradd -c 'bin' -d /dev/null -g bin -u 1 bin</userinput></screen>
     107
     108    <para><application>Courierfilter</application> requires the directory
     109    <filename class="directory">/var/run/courier</filename> to store
     110    all the <application>Courier</application> pid and lockfiles.
     111    <filename class="directory">/var/lock/subsys</filename> also must exist
     112    for the master lock file for <application>Courier</application>. Issue
     113    the following commands to create these directories:</para>
     114
     115<screen role="root"><userinput>install -v -d /var/run/courier -o courier -g courier -m755 &amp;&amp;
     116install -v -d /var/lock/subsys -o root -g root -m755</userinput></screen>
     117
     118    <para>Build <application>Courier</application> as an unprivileged user
     119    with the following commands:</para>
     120
     121<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/courier \
    106122    --datadir=/usr/share/courier --sysconfdir=/etc/courier \
    107123    --localstatedir=/var/lib/courier --with-piddir=/var/run/courier \
    108124    --with-paranoid-smtpext --disable-autorenamesent \
    109125    --enable-workarounds-for-imap-client-bugs --with-db=gdbm &amp;&amp;
    110 make</command></userinput></screen>
    111 
    112 <para>Once again, become the root user and install
    113 <application>Courier</application> with the following commands:</para>
    114 
    115 <screen><userinput role="root"><command>make install &amp;&amp;
    116 make install-configure</command></userinput></screen>
    117 
    118 </sect2>
    119 
    120 <sect2>
    121 <title>Command explanations</title>
    122 
    123 <para><parameter>--libexecdir=/usr/lib/courier</parameter>: Specifies
    124 the directory which contains programs and libraries that cannot be
    125 directly executed from the command-line.</para>
    126 
    127 <para><parameter>--datadir=/usr/share/courier</parameter>: Specifies the
    128 directory where miscellaneous shell scripts,
    129 <application>Perl</application> scripts, and data files will be
    130 installed.</para>
    131 
    132 <para><parameter>--localstatedir=/var/spool/courier</parameter>:
    133 Specifies the directory that will hold the mail queue, and other
    134 temporary data.</para>
    135 
    136 <para><parameter>--with-piddir=/var/run/courier</parameter>: Specifies
    137 the directory where <application>Courier</application>'s
    138 <filename>PID</filename> files are stored when
    139 <application>Courier</application> is active.</para>
    140 
    141 <para><option>--with-paranoid-smtpext</option>: Be paranoid when
    142 negotiating Courier-specific <acronym>ESMTP</acronym> extensions with
    143 remote servers. The <application>Courier</application> mail server
    144 defines and implements certain experimental <acronym>ESMTP</acronym>
    145 extensions: XVERP and XEXDATA. Problems may result in the event that
    146 someone else uses the same name to implement some other extension. If
    147 this option is specified, <application>Courier's</application>
    148 <acronym>ESMTP</acronym> server will also advertise a dummy
    149 <acronym>ESMTP</acronym> capability called XCOURIEREXTENSIONS, and will
    150 not recognize any Courier-specific extensions unless the remote mail
    151 server also advertises this dummy <acronym>ESMTP</acronym>
    152 capability.</para>
    153 
    154 <para><option>--disable-autorenamesent</option>: Do not rename the Sent
    155 folder every month. This option can also be controlled by the
    156 <envar>SQWEBMAIL_AUTORENAMESENT</envar> environment variable.</para>
    157 
    158 <para><option>--enable-workarounds-for-imap-client-bugs</option>: There
    159 are several confirmed bugs in some <acronym>IMAP</acronym> clients that
    160 do not properly implement the <acronym>IMAP</acronym>4rev1 protocol.
    161 This option enables some workarounds for those buggy
    162 <acronym>IMAP</acronym> clients. NOTE: <command>make check</command>
    163 will fail if this option is used. You should first configure without
    164 this option, and if all post-configuration tests succeed, rerun
    165 configure with this option and recompile.</para>
    166 
    167 <para><parameter>--with-db=gdbm</parameter>:
    168 <application>Courier</application> requires either the
    169 <application><acronym>GDBM</acronym></application> or the
    170 <application>DB</application> database library.
    171 <application><acronym>GDBM</acronym></application> is used if both are
    172 present. This option forces the selection of
    173 <application>GDBM</application> as courier is currently broken when used
    174 with <application>DB</application>.</para>
    175 
    176 <!-- # Note - Courier will build fine with <xref linkend="db"/>, but all
    177 the database files will not be created correctly -->
    178 
    179 <para><parameter>--with-ispell=/usr/bin/aspell</parameter>:
    180 <application>Courier</application>'s webmail server can use spell
    181 checking, if <command>configure</command> finds
    182 <application>ispell</application> or if you explicitly set the location
    183 of <application>aspell</application>.</para>
    184 
    185 <para><parameter>--enable-mimetypes=<replaceable>[location of mime.types
    186 file]</replaceable></parameter>: Use this switch if you receive an error
    187 saying that the <filename>mime.types</filename> file could not be found.</para>
    188    
    189 </sect2>
    190 
    191 <sect2 id="etc-courier-star">
    192 <title>Configuring <application>Courier</application></title>
    193 <indexterm zone="courier etc-courier-star">
    194 <primary sortas="e-etc-courier-star">/etc/courier/*</primary></indexterm>
    195 
    196 <sect3><title>Configuration Files</title>
    197 <para><filename>/etc/courier/*</filename></para>
    198 </sect3>
    199 
    200 <sect3><title>Configuration Information</title>
    201 
    202 <para>While still as root, you will need to create the following files with
    203 the contents specified.</para>
    204 
    205 <para><filename>/etc/courier/defaultdomain</filename></para>
    206 
    207 <screen><userinput role="root"><command>cat &gt; /etc/courier/defaultdomain &lt;&lt; "EOF"</command>
    208 <replaceable>[yourdomain]</replaceable>
    209 <command>EOF</command></userinput></screen>
    210 
    211 <para><filename>/etc/courier/me</filename></para>
    212 
    213 <screen><userinput role="root"><command>cat &gt; /etc/courier/me &lt;&lt; "EOF"</command>
    214 <replaceable>[servername.yourdomain]</replaceable>
    215 <command>EOF</command></userinput></screen>
    216 
    217 <para><filename>/etc/courier/locals</filename></para>
    218 
    219 <screen><userinput role="root"><command>cat &gt; /etc/courier/locals &lt;&lt; "EOF"</command>
    220 localhost
    221 <replaceable>[yourdomain]</replaceable>
    222 <command>EOF</command></userinput></screen>
    223 
    224 <para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
    225 
    226 <screen><userinput role="root"><command>cat &gt; /etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"</command>
    227 localhost
    228 <replaceable>[yourdomain]</replaceable>
    229 <command>EOF</command></userinput></screen>
    230 
    231 <para>You will also need to edit the
    232 <filename>/etc/courier/aliases/system</filename> file and change the
    233 following entry.</para>
    234 
    235 <screen><userinput>postmaster: <replaceable>[your administrator email]</replaceable></userinput></screen>
    236 
    237 <para>If you want to deny access from some hosts from sending mail, you
    238 will need to edit the
    239 <filename>/etc/courier/smtpaccess/default</filename> file.</para>
    240 
    241 <para>If you wish to host mail for non local domains including virtual
    242 domains, you must add them to
    243 <filename>/etc/courier/hosteddomains</filename>. This file should exist
    244 whether you need a hosted domain list or not:</para>
    245 
    246 <screen><userinput role="root"><command>touch /etc/courier/hosteddomains</command></userinput></screen>
    247 
    248 <para>After the above steps are completed you will need to run the
    249 following commands:</para>
    250 
    251 <screen><userinput role="root"><command>makesmtpaccess &amp;&amp;
     126make</userinput></screen>
     127
     128    <para>Once again, become the <systemitem class="username">root</systemitem>
     129    user and install <application>Courier</application> with the following
     130    commands:</para>
     131
     132<screen role="root"><userinput>make install &amp;&amp;
     133make install-configure</userinput></screen>
     134
     135  </sect2>
     136
     137  <sect2 role="commands">
     138    <title>Command Explanations</title>
     139
     140    <para><parameter>--libexecdir=/usr/lib/courier</parameter>: Specifies
     141    the directory which contains programs and libraries that cannot be
     142    directly executed from the command-line.</para>
     143
     144    <para><parameter>--datadir=/usr/share/courier</parameter>: Specifies the
     145    directory where miscellaneous shell scripts,
     146    <application>Perl</application> scripts, and data files will be
     147    installed.</para>
     148
     149    <para><parameter>--localstatedir=/var/spool/courier</parameter>:
     150    Specifies the directory that will hold the mail queue, and other
     151    temporary data.</para>
     152
     153    <para><parameter>--with-piddir=/var/run/courier</parameter>: Specifies
     154    the directory where <application>Courier</application>'s
     155    <filename>PID</filename> files are stored when
     156    <application>Courier</application> is active.</para>
     157
     158    <para><parameter>--with-paranoid-smtpext</parameter>: Be paranoid when
     159    negotiating Courier-specific ESMTP extensions with remote servers.
     160    The <application>Courier</application> mail server defines and implements
     161    certain experimental ESMTP extensions: XVERP and XEXDATA. Problems may
     162    result in the event that someone else uses the same name to implement
     163    some other extension. If this option is specified,
     164    <application>Courier's</application> ESMTP server will also advertise a
     165    dummy ESMTP capability called XCOURIEREXTENSIONS, and will not recognize
     166    any Courier-specific extensions unless the remote mail server also
     167    advertises this dummy ESMTP capability.</para>
     168
     169    <para><parameter>--disable-autorenamesent</parameter>: Do not rename the
     170    Sent folder every month. This option can also be controlled by the
     171    <envar>SQWEBMAIL_AUTORENAMESENT</envar> environment variable.</para>
     172
     173    <para><parameter>--enable-workarounds-for-imap-client-bugs</parameter>:
     174    There are several confirmed bugs in some IMAP clients that do not properly
     175    implement the IMAP4rev1 protocol. This option enables some workarounds for
     176    those buggy IMAP clients. NOTE: <command>make check</command> will fail if
     177    this option is used. You should first configure without this option, and
     178    if all post-configuration tests succeed, rerun configure with this option
     179    and recompile.</para>
     180
     181    <para><parameter>--with-db=gdbm</parameter>:
     182    <application>Courier</application> requires either the
     183    <application>GDBM</application> or the <application>DB</application>
     184    database library. <application>GDBM</application> is used if both are
     185    present. This option forces the selection of
     186    <application>GDBM</application> as <application>Courier</application>
     187    is currently broken when used with <application>DB</application>.</para>
     188
     189    <!-- # Note - Courier will build fine with <xref linkend="db"/>, but all
     190    the database files will not be created correctly -->
     191
     192    <para><option>--with-ispell=/usr/bin/aspell</option>:
     193    <application>Courier</application>'s webmail server can use spell
     194    checking, if <command>configure</command> finds
     195    <application>ispell</application> or if you explicitly set the location
     196    of <application>aspell</application>.</para>
     197
     198    <para><option>--enable-mimetypes=<replaceable>[location of mime.types
     199    file]</replaceable></option>: Use this switch if you receive an error
     200    saying that the <filename>mime.types</filename> file could not be
     201    found.</para>
     202
     203  </sect2>
     204
     205  <sect2 role="configuration">
     206    <title>Configuring Courier</title>
     207
     208    <sect3 id="courier-config">
     209      <title>Configuration Files</title>
     210
     211      <para><filename>/etc/courier/*</filename></para>
     212
     213      <indexterm zone="courier courier-config">
     214        <primary sortas="e-etc-courier-star">/etc/courier/*</primary>
     215      </indexterm>
     216
     217    </sect3>
     218
     219    <sect3>
     220      <title>Configuration Information</title>
     221
     222      <para>While still as <systemitem class="username">root</systemitem>,
     223      you will need to create the following files with the contents
     224      specified.</para>
     225
     226      <para><filename>/etc/courier/defaultdomain</filename></para>
     227
     228<screen role="root"><userinput>cat &gt; /etc/courier/defaultdomain &lt;&lt; "EOF"
     229<literal><replaceable>[yourdomain]</replaceable></literal>
     230EOF</userinput></screen>
     231
     232      <para><filename>/etc/courier/me</filename></para>
     233
     234<screen role="root"><userinput>cat &gt; /etc/courier/me &lt;&lt; "EOF"
     235<literal><replaceable>[servername.yourdomain]</replaceable></literal>
     236EOF</userinput></screen>
     237
     238      <para><filename>/etc/courier/locals</filename></para>
     239
     240<screen role="root"><userinput>cat &gt; /etc/courier/locals &lt;&lt; "EOF"
     241<literal>localhost
     242<replaceable>[yourdomain]</replaceable></literal>
     243EOF</userinput></screen>
     244
     245      <para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
     246
     247<screen role="root"><userinput>cat &gt; /etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"
     248<literal>localhost
     249<replaceable>[yourdomain]</replaceable></literal>
     250EOF</userinput></screen>
     251
     252      <para>You will also need to edit the
     253      <filename>/etc/courier/aliases/system</filename> file and change the
     254      following entry.</para>
     255
     256<screen><literal>postmaster: <replaceable>[your administrator email]</replaceable></literal></screen>
     257
     258      <para>If you want to deny access from some hosts from sending mail,
     259      you will need to edit the
     260      <filename>/etc/courier/smtpaccess/default</filename> file.</para>
     261
     262      <para>If you wish to host mail for non local domains including virtual
     263      domains, you must add them to
     264      <filename>/etc/courier/hosteddomains</filename>. This file should exist
     265      whether you need a hosted domain list or not:</para>
     266
     267<screen role="root"><userinput>touch /etc/courier/hosteddomains</userinput></screen>
     268
     269      <para>After the above steps are completed you will need to run the
     270      following commands:</para>
     271
     272<screen role="root"><userinput>makesmtpaccess &amp;&amp;
    252273makehosteddomains &amp;&amp;
    253 makealiases</command></userinput></screen>
    254 
    255 <para>For each user, you will need to create a
    256 <filename class="directory">Maildir</filename> directory:</para>
    257 
    258 <screen><userinput role="root"><command>cd /home/<replaceable>[username]</replaceable> &amp;&amp;
     274makealiases</userinput></screen>
     275
     276      <para>For each user, you will need to create a
     277      <filename class="directory">Maildir</filename> directory:</para>
     278
     279<screen role="root"><userinput>cd /home/<replaceable>[username]</replaceable> &amp;&amp;
    259280maildirmake Maildir &amp;&amp;
    260 chown <replaceable>[username]</replaceable>.<replaceable>[username]</replaceable> Maildir -R</command></userinput></screen>
    261 
    262 <para>If you wish to use <acronym>SSL</acronym> with
    263 <application>Courier</application>, you should obtain certificates and
    264 store them in <filename>/usr/share/courier</filename>.  You can
    265 optionally create self-signed, test certificates with the following
    266 commands:</para>
    267 
    268 <screen><userinput role="root"><command>mkesmtpdcert &amp;&amp;
     281chown <replaceable>[username]</replaceable>.<replaceable>[username]</replaceable> Maildir -R</userinput></screen>
     282
     283      <para>If you wish to use SSL with <application>Courier</application>,
     284      you should obtain certificates and store them in
     285      <filename>/usr/share/courier</filename>.  You can optionally create
     286      self-signed, test certificates with the following commands:</para>
     287
     288<screen role="root"><userinput>mkesmtpdcert &amp;&amp;
    269289mkimapdcert &amp;&amp;
    270 mkpop3dcert</command></userinput></screen>
    271 
    272 <para>All of <application>Courier</application>'s configuration files reside
    273 in the directory <filename class="directory">/etc/courier/</filename>.  For
    274 each service <acronym>SMTP</acronym>, <acronym>POP3</acronym> and
    275 <acronym>IMAP</acronym>, you will have a standard config file, and an
    276 <acronym>SSL</acronym> config file.  For each service that you
    277 wish to utilize, you will need to edit the configuration file, and
    278 change the <replaceable>[DAEMON]</replaceable>START variable from 'NO' to
    279 'YES'.  For example, to use <acronym>SMTP</acronym> with
    280 <acronym>SSL</acronym>, you'll need to edit
    281 <filename>/etc/courier/esmtpd-ssl</filename> and change the value of
    282 'ESMTPDSSLSTART' to 'YES'.  Make the same change for each service
    283 configuration that you wish to use with
    284 <application>Courier</application>.</para>
    285 
    286 <para>If you wish to use <acronym>LDAP</acronym>, an
    287 <acronym>LDAP</acronym> configuration file should be created:</para>
    288 
    289 <screen><userinput role="root"><command>echo "LDAPALIASDSTART=YES" > /etc/courier/ldapaliasd</command></userinput></screen>
    290 
    291 <para>Similarly, if you wish to use webmail, you should create the webmail
    292 configuration file:</para>
    293 
    294 <screen><userinput role="root"><command>echo "WEBMAILDSTART=YES" > /etc/courier/webmaild</command></userinput></screen>
    295 
    296 <para>You will also need to copy the <filename>webmail</filename> file from
    297 <filename>/usr/lib/courier/courier/webmail</filename> to the
    298 <filename class='directory'>cgi-bin</filename> directory of your
    299 <application>Apache</application> server.</para>
    300 
    301 <screen><userinput role="root"><command>cp -a /usr/lib/courier/courier/webmail/webmail /srv/www/cgi-bin</command></userinput></screen>
    302 
    303 <para>You will then need to copy the images to a directory under your
    304 <filename class='directory'>htdocs</filename> directory of your
    305 <application>Apache</application> server. The directory needs to be named
    306 <filename class='directory'>webmail</filename> or you need to specify it
    307 during the configure phase with
    308 <parameter>--enable-imageurl=<replaceable>[URL]</replaceable></parameter>.</para>
    309 
    310 <screen><userinput role="root"><command>cp -a /usr/share/courier/sqwebmail/images /srv/www/htdocs/webmail</command></userinput></screen>
    311 
    312 <para>If you wish to utilze the webadmin utility, you will need to copy the
    313 <filename>webadmin</filename> file from
    314 <filename class="directory">/usr/lib/courier/courier/webmail</filename>
    315 to your <filename class="directory">cgi-bin</filename> directory of your
    316 <application>Apache</application> server.</para>
    317 
    318 <screen><userinput role="root"><command>cp -a /usr/lib/courier/courier/webmail/webadmin /srv/www/cgi-bin</command></userinput></screen>
    319 
    320 <para>You also need to put the password into the file
    321 <filename>/etc/courier/webadmin/password</filename>:</para>
    322 
    323 <screen><userinput role="root"><command>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"</command>
    324 <replaceable>[password]</replaceable>
    325 <command>EOF</command></userinput></screen>
    326 
    327 <para>If you are not using <acronym>SSL</acronym> on your <application>Apache
    328 </application> server, you will also need to add
    329 <filename>/etc/courier/webadmin/unsecureok</filename>, so you will be able
    330 to use your web based administration tool.</para>
    331 
    332 <screen><userinput role="root"><command>touch /etc/courier/webadmin/unsecureok</command></userinput></screen>
    333 
    334 <para>If you use <application>Linux-PAM</application> on your system,
    335 you will need to create the <acronym>PAM</acronym> configuration files:</para>
    336 
    337 <screen><userinput role="root"><command>cat &gt; /etc/pam.d/esmtp &lt;&lt; "EOF"</command>
    338 # Begin /etc/pam.d/esmtp
     290mkpop3dcert</userinput></screen>
     291
     292      <para>All of <application>Courier</application>'s configuration files reside
     293      in the directory <filename class="directory">/etc/courier/</filename>. For
     294      each service SMTP, POP3 and IMAP, you will have a standard config file, and
     295      an SSL config file. For each service that you wish to utilize, you will
     296      need to edit the configuration file, and change the
     297      <replaceable>[DAEMON]</replaceable>START variable from 'NO' to 'YES'. For
     298      example, to use SMTP with SSL, you'll need to edit
     299      <filename>/etc/courier/esmtpd-ssl</filename> and change the value of
     300      'ESMTPDSSLSTART' to 'YES'.  Make the same change for each service
     301      configuration that you wish to use with
     302      <application>Courier</application>.</para>
     303
     304      <para>If you wish to use LDAP, an LDAP configuration file should be
     305      created:</para>
     306
     307<screen role="root"><userinput>echo "LDAPALIASDSTART=YES" > /etc/courier/ldapaliasd</userinput></screen>
     308
     309      <para>Similarly, if you wish to use webmail, you should create the webmail
     310      configuration file:</para>
     311
     312<screen role="root"><userinput>echo "WEBMAILDSTART=YES" > /etc/courier/webmaild</userinput></screen>
     313
     314      <para>You will also need to copy the <filename>webmail</filename> file
     315      from <filename>/usr/lib/courier/courier/webmail</filename> to the
     316      <filename class='directory'>cgi-bin</filename> directory of your
     317      <application>Apache</application> server.</para>
     318
     319<screen role="root"><userinput>cp -v -a /usr/lib/courier/courier/webmail/webmail /srv/www/cgi-bin</userinput></screen>
     320
     321      <para>You will then need to copy the images to a directory under your
     322      <filename class='directory'>htdocs</filename> directory of your
     323      <application>Apache</application> server. The directory needs to be named
     324      <filename class='directory'>webmail</filename> or you need to specify it
     325      during the configure phase with
     326      <option>--enable-imageurl=<replaceable>[URL]</replaceable></option>.</para>
     327
     328<screen role="root"><userinput>cp -v -a /usr/share/courier/sqwebmail/images /srv/www/htdocs/webmail</userinput></screen>
     329
     330      <para>If you wish to utilze the webadmin utility, you will need to copy
     331      the <filename>webadmin</filename> file from
     332      <filename class="directory">/usr/lib/courier/courier/webmail</filename>
     333      to your <filename class="directory">cgi-bin</filename> directory of your
     334      <application>Apache</application> server.</para>
     335
     336<screen role="root"><userinput>cp -v -a /usr/lib/courier/courier/webmail/webadmin /srv/www/cgi-bin</userinput></screen>
     337
     338      <para>You also need to put the password into the file
     339      <filename>/etc/courier/webadmin/password</filename>:</para>
     340
     341<screen role="root"><userinput>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"
     342<literal><replaceable>[password]</replaceable></literal>
     343EOF</userinput></screen>
     344
     345      <para>If you are not using SSL on your <application>Apache</application>
     346      server, you will also need to add
     347      <filename>/etc/courier/webadmin/unsecureok</filename>, so you will be
     348      able to use your web based administration tool.</para>
     349
     350<screen role="root"><userinput>touch /etc/courier/webadmin/unsecureok</userinput></screen>
     351
     352      <para>If you use <application>Linux-PAM</application> on your system,
     353      you will need to create the PAM configuration files:</para>
     354
     355<screen role="root"><userinput>cat &gt; /etc/pam.d/esmtp &lt;&lt; "EOF"
     356<literal># Begin /etc/pam.d/esmtp
    339357
    340358auth            required                pam_unix.so try_first_pass
    … …  
    342360session         required                pam_unix.so
    343361
    344 # End /etc/pam.d/esmtp
    345 <command>EOF
    346 cat &gt; /etc/pam.d/pop3 &lt;&lt; "EOF"</command>
     362# End /etc/pam.d/esmtp</literal>
     363EOF
     364<literal>cat &gt; /etc/pam.d/pop3 &lt;&lt; "EOF"
    347365# Begin /etc/pam.d/pop3
    348366
    … …  
    351369session         required                pam_unix.so
    352370
    353 # End /etc/pam.d/pop3
    354 <command>EOF
    355 cat &gt; /etc/pam.d/imap &lt;&lt; "EOF"</command>
    356 # Begin /etc/pam.d/imap
     371# End /etc/pam.d/pop3</literal>
     372EOF
     373cat &gt; /etc/pam.d/imap &lt;&lt; "EOF"
     374<literal># Begin /etc/pam.d/imap
    357375
    358376auth            required                pam_unix.so try_first_pass
    … …  
    360378session         required                pam_unix.so
    361379
    362 # End /etc/pam.d/imap
    363 <command>EOF
    364 cat &gt; /etc/pam.d/webmail &lt;&lt; "EOF"</command>
    365 # Begin /etc/pam.d/webmail
     380# End /etc/pam.d/imap</literal>
     381EOF
     382cat &gt; /etc/pam.d/webmail &lt;&lt; "EOF"
     383<literal># Begin /etc/pam.d/webmail
    366384
    367385auth            required                pam_unix.so try_first_pass
    … …  
    369387session         required                pam_unix.so
    370388
    371 # End /etc/pam.d/webmail
    372 <command>EOF</command></userinput></screen>
    373 
    374 <para id="courier-init">Finally, if you wish to start the
    375 <application>Courier</application> server at boot, install
    376 the <filename>/etc/rc.d/init.d/courier</filename> bootscript included in the
    377 <xref linkend="intro-important-bootscripts"/> package.</para>
    378 <indexterm zone="courier courier-init">
    379 <primary sortas="f-courier-init">courier</primary></indexterm>
    380 
    381 <screen><userinput role="root"><command>make install-courier</command></userinput></screen>
    382 
    383 </sect3>
     389# End /etc/pam.d/webmail</literal>
     390EOF</userinput></screen>
     391
     392    </sect3>
     393
     394    <sect3  id="courier-init">
     395      <title>Boot Script</title>
     396
     397      <para>Finally, if you wish to start the
     398      <application>Courier</application> server at boot, install the
     399      <filename>/etc/rc.d/init.d/courier</filename> bootscript included
     400      in the <xref linkend="intro-important-bootscripts"/> package.</para>
     401
     402      <indexterm zone="courier courier-init">
     403        <primary sortas="f-courier-init">courier</primary>
     404      </indexterm>
     405
     406<screen role="root"><userinput>make install-courier</userinput></screen>
     407
     408    </sect3>
    384409
    385410<!-- Begin virtual user setup * To be removed once added to the hint. -->
    386411
    387 <sect3>
    388 
    389 <title>Configuring for virtual users</title>
    390 
    391 <para>These instructions will configure <application>Courier</application>
    392 to lookup virtual users in a <application>MySQL</application> database.
    393 Begin by making the following changes to
    394 <filename>/etc/courier/authmysqlrc</filename>:</para>
    395 
    396 <screen><userinput>MYSQL_SERVER            localhost
     412    <sect3>
     413      <title>Configuring for Virtual Users</title>
     414
     415      <para>These instructions will configure <application>Courier</application>
     416      to lookup virtual users in a <application>MySQL</application> database.
     417      Begin by making the following changes to
     418      <filename>/etc/courier/authmysqlrc</filename>:</para>
     419
     420<screen><literal>MYSQL_SERVER            localhost
    397421MYSQL_USERNAME          courier
    398422MYSQL_PASSWORD          <replaceable>[your choice]</replaceable>
    … …  
    403427MYSQL_CLEAR_PWFIELD     clear
    404428DEFAULT DOMAIN          <replaceable>[your domain]</replaceable>
    405 MYSQL_QUOTA_FIELD       quota</userinput></screen>
    406 
    407 <para>Connect to <application>MySQL</application>:</para>
    408 
    409 <screen><userinput role="root"><command>mysql -p</command></userinput></screen>
    410 
    411 <para>Create the <filename>courier_mail</filename> database and setup
    412 the users table:</para>
    413 
    414 <screen><userinput role="root"><command>CREATE DATABASE courier_mail;
     429MYSQL_QUOTA_FIELD       quota</literal></screen>
     430
     431      <para>Connect to <application>MySQL</application>:</para>
     432
     433<screen role="root"><userinput>mysql -p</userinput></screen>
     434
     435      <para>Create the <filename>courier_mail</filename> database and setup
     436      the users table:</para>
     437
     438<screen role="root"><userinput>CREATE DATABASE courier_mail;
    415439USE courier_mail
    416440CREATE TABLE users (
    … …  
    424448quota                 char(255) DEFAULT '' NOT NULL,
    425449KEY id (id(128))
    426 );</command></userinput></screen>
    427 
    428 <para>Grant all priveledges to the courier user created earlier:</para>
    429 
    430 <screen><userinput role="root"><command>GRANT ALL PRIVILEGES ON *.* TO courier@localhost \
     450);</userinput></screen>
     451
     452      <para>Grant all priveledges to the <systemitem
     453      class="username">courier</systemitem> user created earlier:</para>
     454
     455<screen role="root"><userinput>GRANT ALL PRIVILEGES ON *.* TO courier@localhost \
    431456    IDENTIFIED BY '<replaceable>[password]</replaceable>' WITH GRANT OPTION;
    432 QUIT</command></userinput></screen>
    433 
    434 <para>Create a virtual mailman user and group:</para>
    435 <screen><userinput role="root"><command>groupadd -g 9000 vmailman &amp;&amp;
    436 useradd -c 'Virtual Mailman' -g vmailman -m -k /dev/null -u 9000 vmailman</command></userinput></screen>
    437 
    438 <para>Create a mail directory for a new virtual user:</para>
    439 
    440 <screen><userinput role="root"><command>cd /home/vmailman &amp;&amp;
     457QUIT</userinput></screen>
     458
     459      <para>Create a virtual mailman user and group:</para>
     460
     461<screen role="root"><userinput>groupadd -g 9000 vmailman &amp;&amp;
     462useradd -c 'Virtual Mailman' -g vmailman -m -k /dev/null -u 9000 vmailman</userinput></screen>
     463
     464      <para>Create a mail directory for a new virtual user:</para>
     465
     466<screen role="root"><userinput>cd /home/vmailman &amp;&amp;
    441467mkdir <replaceable>[virtual_user]</replaceable> &amp;&amp;
    442468cd <replaceable>[virtual_user]</replaceable> &amp;&amp;
    443469maildirmake Maildir &amp;&amp;
    444 chown vmailman.vmailman Maildir -R</command></userinput></screen>
    445 
    446 <para>Now, connect the the <application>MySQL</application> database as
    447 the courier user:</para>
    448 
    449 <screen><userinput role="root"><command>mysql -u courier -p</command></userinput></screen>
    450 
    451 <para>To add the virtual user you need to enter at least one version of the
    452 password either clear text or encrypted.</para>
    453 
    454 <para>Add the first virtual user with the following commands:</para>
    455 
    456 <screen><userinput role="root"><command>USE courier_mail
     470chown vmailman.vmailman Maildir -R</userinput></screen>
     471
     472      <para>Now, connect the the <application>MySQL</application> database as
     473      the <systemitem class="username">courier</systemitem> user:</para>
     474
     475<screen role="root"><userinput>mysql -u courier -p</userinput></screen>
     476
     477      <para>To add the virtual user you need to enter at least one version of the
     478      password either clear text or encrypted.</para>
     479
     480      <para>Add the first virtual user with the following commands:</para>
     481
     482<screen><userinput>USE courier_mail
    457483INSERT INTO users VALUES (
    458484'<replaceable>[virtual_users]</replaceable>@<replaceable>[domain.com]</replaceable>,
    … …  
    465491'<replaceable>[Quota in Bytes']</replaceable>
    466492);
    467 QUIT</command></userinput></screen>
    468 
    469 <para>For example:</para>
    470 
    471 <screen><userinput role="root"><command>INSERT INTO users VALUES (
     493QUIT</userinput></screen>
     494
     495      <para>For example:</para>
     496
     497<screen><userinput>INSERT INTO users VALUES (
    472498'blfsuser@linuxfromscratch.org',
    473499'',
    … …  
    478504'/home/vmailman/blfsuser',
    479505''
    480 );</command></userinput></screen>
    481 
    482 </sect3>
     506);</userinput></screen>
     507
     508    </sect3>
    483509
    484510<!-- End of Virtual user setup  -->
    485511
    486 </sect2>
    487 
    488 <sect2>
    489 <title>Contents</title>
    490 
    491 <segmentedlist>
    492 <segtitle>Installed Programs</segtitle>
    493 <segtitle>Installed Directories</segtitle>
    494 <seglistitem>
    495 <seg>addcr, authenumerate, cancelmsg, courier, courier-config,
    496 courieresmtpd, courierfilter, courierlogger, couriermlm, couriertcpd,
    497 couriertls, deliverquota, dotforward, esmtpd, esmtpd-msa, esmtpd-ssl,
    498 filterctl, imapd, imapd-ssl, lockmail, mailbot, maildiracl, maildirkw,
    499 maildirmake, maildrop, mailq, makeacceptmailfor, makealiases, makedat,
    500 makehosteddomains, makemime, makepercentrelay, makesmtpaccess,
    501 makesmtpaccess-msa, makeuserdb, makeuucpneighbors, mimegpg,
    502 mkesmtpdcert, mkimapdcert, mkpop3dcert, pop3d, pop3d-ssl, preline,
    503 pw2userdb, reformail, reformime, rmail, sendmail, sharedindexinstall,
    504 sharedindexsplit, showconfig, showmodules, testmxlookup, userdb,
    505 userdbpw, vchkpw2userdb, webgpg, webmaild</seg>
    506 
    507 <seg>/etc/courier, /usr/lib/courier, /usr/share/courier, /var/lib/courier,
    508 /var/lock/subsys, /var/run/courier and /var/spool/courier</seg>
    509 
    510 </seglistitem>
    511 </segmentedlist>
    512 
    513 <variablelist>
    514 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    515 <?dbfo list-presentation="list"?>
    516 
    517 <varlistentry id="cancelmsg">
    518 <term><command>cancelmsg</command></term>
    519 <listitem><para>removes a message from the mail queue.</para>
    520 <indexterm zone="courier cancelmsg">
    521 <primary sortas="b-cancelmsg">cancelmsg</primary></indexterm>
    522 </listitem>
    523 </varlistentry>
    524 
    525 <varlistentry id="courier-prog">
    526 <term><command>courier</command></term>
    527 <listitem><para>is an administrative command used to control the
    528 <application>Courier</application> scheduling engine.</para>
    529 <indexterm zone="courier courier-prog">
    530 <primary sortas="b-courier">courier</primary></indexterm>
    531 </listitem>
    532 </varlistentry>
    533 
    534 <varlistentry id="courierfax">
    535 <term><command>courierfax</command></term>
    536 <listitem><para>sends email messages by fax.</para>
    537 <indexterm zone="courier courierfax">
    538 <primary sortas="b-courierfax">courierfax</primary></indexterm>
    539 </listitem>
    540 </varlistentry>
    541 
    542 <varlistentry id="courierfilter">
    543 <term><command>courierfilter</command></term>
    544 <listitem><para>starts and stops all mail filters installed by
    545 <command>filterctl</command>.</para>
    546 <indexterm zone="courier courierfilter">
    547 <primary sortas="b-courierfilter">courierfilter</primary></indexterm>
    548 </listitem>
    549 </varlistentry>
    550 
    551 <varlistentry id="courierldapaliasd">
    552 <term><command>courierldapaliasd</command></term>
    553 <listitem><para>supports mail address aliasing using an LDAP directory.</para>
    554 <indexterm zone="courier courierldapaliasd">
    555 <primary sortas="b-courierldapaliasd">courierldapaliasd</primary></indexterm>
    556 </listitem>
    557 </varlistentry>
    558 
    559 <varlistentry id="courierlogger">
    560 <term><command>courierlogger</command></term>
    561 <listitem><para>captures error messages from other
    562 <application>Courier</application> applications and forwards them to
    563 the system logger.</para>
    564 <indexterm zone="courier courierlogger">
    565 <primary sortas="b-courierlogger">courierlogger</primary></indexterm>
    566 </listitem>
    567 </varlistentry>
    568 
    569 <varlistentry id="couriermlm">
    570 <term><command>couriermlm</command></term>
    571 <listitem><para>sets up, maintains, and manages mailing lists.</para>
    572 <indexterm zone="courier couriermlm">
    573 <primary sortas="b-couriermlm">couriermlm</primary></indexterm>
    574 </listitem>
    575 </varlistentry>
    576 
    577 <varlistentry id="courierperlfilter">
    578 <term><command>courierperlfilter</command></term>
    579 <listitem><para>is a sample filter written in
    580 <application>Perl</application>.</para>
    581 <indexterm zone="courier courierperlfilter">
    582 <primary sortas="b-courierperlfilter">courierperlfilter</primary></indexterm>
    583 </listitem>
    584 </varlistentry>
    585 
    586 <varlistentry id="courierpop3d">
    587 <term><command>courierpop3d</command></term>
    588 <listitem><para>is a <application>Courier</application>
    589 <acronym>POP</acronym>3 server.</para>
    590 <indexterm zone="courier courierpop3d">
    591 <primary sortas="b-courierpop3d">courierpop3d</primary></indexterm>
    592 </listitem>
    593 </varlistentry>
    594 
    595 <varlistentry id="courierpop3login">
    596 <term><command>courierpop3login</command></term>
    597 <listitem><para>reads the <acronym>POP</acronym>3 userid and password and
    598 passes them to the authentication modules.</para>
    599 <indexterm zone="courier courierpop3login">
    600 <primary sortas="b-courierpop3login">courierpop3login</primary></indexterm>
    601 </listitem>
    602 </varlistentry>
    603 
    604 <varlistentry id="couriertcpd">
    605 <term><command>couriertcpd</command></term>
    606 <listitem><para>accepts incoming network connections, and runs other
    607 <application>Courier</application> programs after establishing each network
    608 connection.</para>
    609 <indexterm zone="courier couriertcpd">
    610 <primary sortas="b-couriertcpd">couriertcpd</primary></indexterm>
    611 </listitem>
    612 </varlistentry>
    613 
    614 <varlistentry id="couriertls">
    615 <term><command>couriertls</command></term>
    616 <listitem><para>is used by applications to encrypt a network connection
    617 using <acronym>SSL</acronym>/<acronym>TLS</acronym>.</para>
    618 <indexterm zone="courier couriertls">
    619 <primary sortas="b-couriertls">couriertls</primary></indexterm>
    620 </listitem>
    621 </varlistentry>
    622 
    623 <varlistentry id="dotforward">
    624 <term><command>dotforward</command></term>
    625 <listitem><para>is a compatibility module that reads forwarding
    626 instructions in <filename>$HOME/.forward</filename>.</para>
    627 <indexterm zone="courier dotforward">
    628 <primary sortas="b-dotforward">dotforward</primary></indexterm>
    629 </listitem>
    630 </varlistentry>
    631 
    632 <varlistentry id="dupfilter">
    633 <term><command>dupfilter</command></term>
    634 <listitem><para>is a threaded filter that tries to block junk E-mail by
    635 attempting to detect multiple copies of the same message, which are
    636 rejected.</para>
    637 <indexterm zone="courier dupfilter">
    638 <primary sortas="b-dupfilter">dupfilter</primary></indexterm>
    639 </listitem>
    640 </varlistentry>
    641 
    642 <varlistentry id="esmtpd">
    643 <term><command>esmtpd</command></term>
    644 <listitem><para>is a control script for courieresmtpd.</para>
    645 <indexterm zone="courier esmtpd">
    646 <primary sortas="b-esmtpd">esmtpd</primary></indexterm>
    647 </listitem>
    648 </varlistentry>
    649 
    650 <varlistentry id="esmtpd-msa">
    651 <term><command>esmtpd-msa</command></term>
    652 <listitem><para>is a control script for courieresmtpd, but adds message
    653 submission port 587 for the <acronym>MSA</acronym> protocol.</para>
    654 <indexterm zone="courier esmtpd-msa">
    655 <primary sortas="b-esmtpd-msa">esmtpd-msa</primary></indexterm>
    656 </listitem>
    657 </varlistentry>
    658 
    659 <varlistentry id="filterctl">
    660 <term><command>filterctl</command></term>
    661 <listitem><para>installs or uninstalls global mail filters.</para>
    662 <indexterm zone="courier filterctl">
    663 <primary sortas="b-filterctl">filterctl</primary></indexterm>
    664 </listitem>
    665 </varlistentry>
    666 
    667 <varlistentry id="imapd">
    668 <term><command>imapd</command></term>
    669 <listitem><para>is the
    670 <application>Courier</application>-<acronym>IMAP</acronym>
    671 server.</para>
    672 <indexterm zone="courier imapd">
    673 <primary sortas="b-imapd">imapd</primary></indexterm>
    674 </listitem>
    675 </varlistentry>
    676 
    677 <varlistentry id="lockmail">
    678 <term><command>lockmail</command></term>
    679 <listitem><para>is a helper utility for locking  mailbox files.</para>
    680 <indexterm zone="courier lockmail">
    681 <primary sortas="b-lockmail">lockmail</primary></indexterm>
    682 </listitem>
    683 </varlistentry>
    684 
    685 <varlistentry id="mailbot">
    686 <term><command>mailbot</command></term>
    687 <listitem><para>is a <acronym>MIME</acronym>-aware autoresponder utility.</para>
    688 <indexterm zone="courier mailbot">
    689 <primary sortas="b-mailbot">mailbot</primary></indexterm>
    690 </listitem>
    691 </varlistentry>
    692 
    693 <varlistentry id="maildiracl">
    694 <term><command>maildiracl</command></term>
    695 <listitem><para>manages access control lists.</para>
    696 <indexterm zone="courier maildiracl">
    697 <primary sortas="b-maildiracl">maildiracl</primary></indexterm>
    698 </listitem>
    699 </varlistentry>
    700 
    701 <varlistentry id="maildirkw">
    702 <term><command>maildirkw</command></term>
    703 <listitem><para>modifies
    704 <application>Courier</application>-<acronym>IMAP</acronym> compatible maildir
    705 message keywords.</para>
    706 <indexterm zone="courier maildirkw">
    707 <primary sortas="b-maildirkw">maildirkw</primary></indexterm>
    708 </listitem>
    709 </varlistentry>
    710 
    711 <varlistentry id="maildirmake">
    712 <term><command>maildirmake</command></term>
    713 <listitem><para>creates maildirs, and maildir folders.</para>
    714 <indexterm zone="courier maildirmake">
    715 <primary sortas="b-maildirmake">maildirmake</primary></indexterm>
    716 </listitem>
    717 </varlistentry>
    718 
    719 <varlistentry id="maildrop">
    720 <term><command>maildrop</command></term>
    721 <listitem><para>is a replacement local mail delivery agent that includes a
    722 mail filtering language.</para>
    723 <indexterm zone="courier maildrop">
    724 <primary sortas="b-maildrop">maildrop</primary></indexterm>
    725 </listitem>
    726 </varlistentry>
    727 
    728 <varlistentry id="mailq-courier">
    729 <term><command>mailq</command></term>
    730 <listitem><para>displays a list of all messages that have not been
    731 delivered yet.</para>
    732 <indexterm zone="courier mailq-courier">
    733 <primary sortas="b-mailq">mailq</primary></indexterm>
    734 </listitem>
    735 </varlistentry>
    736 
    737 <varlistentry id="makeacceptmailfor">
    738 <term><command>makeacceptmailfor</command></term>
    739 <listitem><para>builds a list of domains to accept mail for, from the
    740 <filename class="directory">/etc/courier/esmtpacceptmailfor.dir</filename>
    741 directory.</para>
    742 <indexterm zone="courier makeacceptmailfor">
    743 <primary sortas="b-makeacceptmailfor">makeacceptmailfor</primary></indexterm>
    744 </listitem>
    745 </varlistentry>
    746 
    747 <varlistentry id="makealiases">
    748 <term><command>makealiases</command></term>
    749 <listitem><para>builds an alias database from one or more plain text
    750 source files.</para>
    751 <indexterm zone="courier makealiases">
    752 <primary sortas="b-makealiases">makealiases</primary></indexterm>
    753 </listitem>
    754 </varlistentry>
    755 
    756 <varlistentry id="makedat">
    757 <term><command>makedat</command></term>
    758 <listitem><para>is a utility to create <application>GDBM</application> or
    759 <application>DB</application> files from plain text files.</para>
    760 <indexterm zone="courier makedat">
    761 <primary sortas="b-makedat">makedat</primary></indexterm>
    762 </listitem>
    763 </varlistentry>
    764 
    765 <varlistentry id="makehosteddomains">
    766 <term><command>makehosteddomains</command></term>
    767 <listitem><para>rebuilds the contents of the hosteddomains database from the
    768 contents of <filename>/tools/etc/courier/hosteddomains</filename>.</para>
    769 <indexterm zone="courier makehosteddomains">
    770 <primary sortas="b-makehosteddomains">makehosteddomains</primary></indexterm>
    771 </listitem>
    772 </varlistentry>
    773 
    774 <varlistentry id="makemime">
    775 <term><command>makemime</command></term>
    776 <listitem><para>creates <acronym>MIME</acronym>-formatted messages from one
    777 or more files.</para>
    778 <indexterm zone="courier makemime">
    779 <primary sortas="b-makemime">makemime</primary></indexterm>
    780 </listitem>
    781 </varlistentry>
    782 
    783 <varlistentry id="makepercentrelay">
    784 <term><command>makepercentrelay</command></term>
    785 <listitem><para>builds a list of %-relayed domains from the
    786 <filename class="directory">percentrelay.dir</filename> directory.</para>
    787 <indexterm zone="courier makepercentrelay">
    788 <primary sortas="b-makepercentrelay">makepercentrelay</primary></indexterm>
    789 </listitem>
    790 </varlistentry>
    791 
    792 <varlistentry id="makesmtpaccess">
    793 <term><command>makesmtpaccess</command></term>
    794 <listitem><para>builds <acronym>ESMTP</acronym> server access files from the
    795 <filename class="directory">/etc/courier/smtpaccess</filename>
    796 directory.</para>
    797 <indexterm zone="courier makesmtpaccess">
    798 <primary sortas="b-makesmtpaccess">makesmtpaccess</primary></indexterm>
    799 </listitem>
    800 </varlistentry>
    801 
    802 <varlistentry id="makesmtpaccess-msa">
    803 <term><command>makesmtpaccess-msa</command></term>
    804 <listitem><para>builds <acronym>ESMTP</acronym> server access files from the
    805 <filename class="directory">/etc/courier/smtpaccess</filename> directory.
    806 This esmtp list is for the <acronym>MSA</acronym> protocol.</para>
    807 <indexterm zone="courier makesmtpaccess-msa">
    808 <primary sortas="b-makesmtpaccess-msa">makesmtpaccess-msa</primary></indexterm>
    809 </listitem>
    810 </varlistentry>
    811 
    812 <varlistentry id="makeuserdb">
    813 <term><command>makeuserdb</command></term>
    814 <listitem><para>builds a user/password db from the contents
    815 of <filename class="directory">/tools/etc/courier/userdb</filename>.</para>
    816 <indexterm zone="courier makeuserdb">
    817 <primary sortas="b-makeuserdb">makeuserdb</primary></indexterm>
    818 </listitem>
    819 </varlistentry>
    820 
    821 <varlistentry id="mimegpg">
    822 <term><command>mimegpg</command></term>
    823 <listitem><para>signs, encrypts, or decrypts <acronym>MIME</acronym>-formatted
    824 email messages using <application>GnuPG</application>.</para>
    825 <indexterm zone="courier mimegpg">
    826 <primary sortas="b-mimegpg">mimegpg</primary></indexterm>
    827 </listitem>
    828 </varlistentry>
    829 
    830 <varlistentry id="mkesmtpdcert">
    831 <term><command>mkesmtpdcert</command></term>
    832 <listitem><para>creates a secure <acronym>SMTP</acronym> test
    833 certificate.</para>
    834 <indexterm zone="courier mkesmtpdcert">
    835 <primary sortas="b-mkesmtpdcert">mkesmtpdcert</primary></indexterm>
    836 </listitem>
    837 </varlistentry>
    838 
    839 <varlistentry id="mkimapdcert">
    840 <term><command>mkimapdcert</command></term>
    841 <listitem><para>creates a secure <acronym>IMAP</acronym> test
    842 certificate.</para>
    843 <indexterm zone="courier mkimapdcert">
    844 <primary sortas="b-mkimapdcert">mkimapdcert</primary></indexterm>
    845 </listitem>
    846 </varlistentry>
    847 
    848 <varlistentry id="mkpop3dcert">
    849 <term><command>mkpop3dcert</command></term>
    850 <listitem><para>creates a secure <acronym>POP3</acronym> test
    851 certificate.</para>
    852 <indexterm zone="courier mkpop3dcert">
    853 <primary sortas="b-mkpop3dcert">mkpop3dcert</primary></indexterm>
    854 </listitem>
    855 </varlistentry>
    856 
    857 <varlistentry id="pop3d">
    858 <term><command>pop3d</command></term>
    859 <listitem><para>is a wrapper script for <command>couriertcpd</command> to
    860 start and stop the <acronym>POP3</acronym> service.</para>
    861 <indexterm zone="courier pop3d">
    862 <primary sortas="b-pop3d">pop3d</primary></indexterm>
    863 </listitem>
    864 </varlistentry>
    865 
    866 <varlistentry id="pop3d-ssl">
    867 <term><command>pop3d-ssl</command></term>
    868 <listitem><para>is a wrapper script for <command>couriertcpd</command> to
    869 start and stop the <acronym>POP3</acronym> over <acronym>SSL</acronym>
    870 service.</para>
    871 <indexterm zone="courier pop3d-ssl">
    872 <primary sortas="b-pop3d-ssl">pop3d-ssl</primary></indexterm>
    873 </listitem>
    874 </varlistentry>
    875 
    876 <varlistentry id="preline">
    877 <term><command>preline</command></term>
    878 <listitem><para>prepends legacy <filename>mbox</filename> headers to mail
    879 messages.</para>
    880 <indexterm zone="courier preline">
    881 <primary sortas="b-preline">preline</primary></indexterm>
    882 </listitem>
    883 </varlistentry>
    884 
    885 <varlistentry id="reformail">
    886 <term><command>reformail</command></term>
    887 <listitem><para>reads a message on standard input, reformats it in some
    888 way, and writes the message to standard output.</para>
    889 <indexterm zone="courier reformail">
    890 <primary sortas="b-reformail">reformail</primary></indexterm>
    891 </listitem>
    892 </varlistentry>
    893 
    894 <varlistentry id="reformime">
    895 <term><command>reformime</command></term>
    896 <listitem><para>is a utility for reformatting <acronym>MIME</acronym>
    897 messages.</para>
    898 <indexterm zone="courier reformime">
    899 <primary sortas="b-reformime">reformime</primary></indexterm>
    900 </listitem>
    901 </varlistentry>
    902 
    903 <varlistentry id="sendmail-courier">
    904 <term><command>sendmail</command></term>
    905 <listitem><para>reads an email message and delivers the message to its
    906 recipients.</para>
    907 <indexterm zone="courier sendmail-courier">
    908 <primary sortas="b-sendmail">sendmail</primary></indexterm>
    909 </listitem>
    910 </varlistentry>
    911 
    912 <varlistentry id="submit">
    913 <term><command>submit</command></term>
    914 <listitem><para>submits messages to <application>Courier</application> for
    915 processing.</para>
    916 <indexterm zone="courier submit">
    917 <primary sortas="b-submit">submit</primary></indexterm>
    918 </listitem>
    919 </varlistentry>
    920 
    921 <varlistentry id="testmxlookup">
    922 <term><command>testmxlookup</command></term>
    923 <listitem><para>lists the names and <acronym>IP</acronym> addresses of mail
    924 relays that receive mail for the domain.</para>
    925 <indexterm zone="courier testmxlookup">
    926 <primary sortas="b-testmxlookup">testmxlookup</primary></indexterm>
    927 </listitem>
    928 </varlistentry>
    929 
    930 <varlistentry id="userdb">
    931 <term><command>userdb</command></term>
    932 <listitem><para>is a script to individually manipulate entries in
    933 <filename>/tools/etc/courier/userdb.</filename></para>
    934 <indexterm zone="courier userdb">
    935 <primary sortas="b-userdb">userdb</primary></indexterm>
    936 </listitem>
    937 </varlistentry>
    938 
    939 <varlistentry id="userdbpw">
    940 <term><command>userdbpw</command></term>
    941 <listitem><para>reads a single line of text on standard input, encrypts
    942 it, and prints the encrypted result to standard output.</para>
    943 <indexterm zone="courier userdbpw">
    944 <primary sortas="b-userdbpw">userdbpw</primary></indexterm>
    945 </listitem>
    946 </varlistentry>
    947 </variablelist>
    948 
    949 </sect2>
     512  </sect2>
     513
     514  <sect2 role="content">
     515    <title>Contents</title>
     516
     517    <segmentedlist>
     518      <segtitle>Installed Programs</segtitle>
     519      <segtitle>Installed Libraries</segtitle>
     520      <segtitle>Installed Directories</segtitle>
     521
     522      <seglistitem>
     523        <seg>addcr, authenumerate, cancelmsg, courier, courier-config,
     524        courieresmtpd, courierfilter, courierlogger, couriermlm, couriertcpd,
     525        couriertls, deliverquota, dotforward, esmtpd, esmtpd-msa, esmtpd-ssl,
     526        filterctl, imapd, imapd-ssl, lockmail, mailbot, maildiracl, maildirkw,
     527        maildirmake, maildrop, mailq, makeacceptmailfor, makealiases, makedat,
     528        makehosteddomains, makemime, makepercentrelay, makesmtpaccess,
     529        makesmtpaccess-msa, makeuserdb, makeuucpneighbors, mimegpg,
     530        mkesmtpdcert, mkimapdcert, mkpop3dcert, pop3d, pop3d-ssl, preline,
     531        pw2userdb, reformail, reformime, rmail, sendmail, sharedindexinstall,
     532        sharedindexsplit, showconfig, showmodules, testmxlookup, userdb,
     533        userdbpw, vchkpw2userdb, webgpg, and webmaild</seg>
     534        <seg>None</seg>
     535        <seg>/etc/courier, /usr/lib/courier, /usr/share/courier, /var/lib/courier,
     536        /var/lock/subsys, /var/run/courier, and /var/spool/courier</seg>
     537      </seglistitem>
     538    </segmentedlist>
     539
     540    <variablelist>
     541      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     542      <?dbfo list-presentation="list"?>
     543      <?dbhtml list-presentation="table"?>
     544
     545      <varlistentry id="cancelmsg">
     546        <term><command>cancelmsg</command></term>
     547        <listitem>
     548          <para>removes a message from the mail queue.</para>
     549          <indexterm zone="courier cancelmsg">
     550            <primary sortas="b-cancelmsg">cancelmsg</primary>
     551          </indexterm>
     552        </listitem>
     553      </varlistentry>
     554
     555      <varlistentry id="courier-prog">
     556        <term><command>courier</command></term>
     557        <listitem>
     558          <para>is an administrative command used to control the
     559          <application>Courier</application> scheduling engine.</para>
     560          <indexterm zone="courier courier-prog">
     561            <primary sortas="b-courier">courier</primary>
     562          </indexterm>
     563        </listitem>
     564      </varlistentry>
     565
     566      <varlistentry id="courierfax">
     567        <term><command>courierfax</command></term>
     568        <listitem>
     569          <para>sends email messages by fax.</para>
     570          <indexterm zone="courier courierfax">
     571            <primary sortas="b-courierfax">courierfax</primary>
     572          </indexterm>
     573        </listitem>
     574      </varlistentry>
     575
     576      <varlistentry id="courierfilter">
     577        <term><command>courierfilter</command></term>
     578        <listitem>
     579          <para>starts and stops all mail filters installed by
     580          <command>filterctl</command>.</para>
     581          <indexterm zone="courier courierfilter">
     582            <primary sortas="b-courierfilter">courierfilter</primary>
     583          </indexterm>
     584        </listitem>
     585      </varlistentry>
     586
     587      <varlistentry id="courierldapaliasd">
     588        <term><command>courierldapaliasd</command></term>
     589        <listitem>
     590          <para>supports mail address aliasing using an LDAP directory.</para>
     591          <indexterm zone="courier courierldapaliasd">
     592            <primary sortas="b-courierldapaliasd">courierldapaliasd</primary>
     593          </indexterm>
     594        </listitem>
     595      </varlistentry>
     596
     597      <varlistentry id="courierlogger">
     598        <term><command>courierlogger</command></term>
     599        <listitem>
     600          <para>captures error messages from other
     601          <application>Courier</application> applications and forwards them
     602          to the system logger.</para>
     603          <indexterm zone="courier courierlogger">
     604            <primary sortas="b-courierlogger">courierlogger</primary>
     605          </indexterm>
     606        </listitem>
     607      </varlistentry>
     608
     609      <varlistentry id="couriermlm">
     610        <term><command>couriermlm</command></term>
     611        <listitem>
     612          <para>sets up, maintains, and manages mailing lists.</para>
     613          <indexterm zone="courier couriermlm">
     614            <primary sortas="b-couriermlm">couriermlm</primary>
     615          </indexterm>
     616        </listitem>
     617      </varlistentry>
     618
     619      <varlistentry id="courierperlfilter">
     620        <term><command>courierperlfilter</command></term>
     621        <listitem>
     622          <para>is a sample filter written in
     623          <application>Perl</application>.</para>
     624          <indexterm zone="courier courierperlfilter">
     625            <primary sortas="b-courierperlfilter">courierperlfilter</primary>
     626          </indexterm>
     627        </listitem>
     628      </varlistentry>
     629
     630      <varlistentry id="courierpop3d">
     631        <term><command>courierpop3d</command></term>
     632        <listitem>
     633          <para>is a <application>Courier</application>
     634          POP3 server.</para>
     635          <indexterm zone="courier courierpop3d">
     636            <primary sortas="b-courierpop3d">courierpop3d</primary>
     637          </indexterm>
     638        </listitem>
     639      </varlistentry>
     640
     641      <varlistentry id="courierpop3login">
     642        <term><command>courierpop3login</command></term>
     643        <listitem>
     644          <para>reads the POP3 userid and password and
     645          passes them to the authentication modules.</para>
     646          <indexterm zone="courier courierpop3login">
     647            <primary sortas="b-courierpop3login">courierpop3login</primary>
     648          </indexterm>
     649        </listitem>
     650      </varlistentry>
     651
     652      <varlistentry id="couriertcpd">
     653        <term><command>couriertcpd</command></term>
     654        <listitem>
     655          <para>accepts incoming network connections, and runs other
     656          <application>Courier</application> programs after establishing each
     657          network connection.</para>
     658          <indexterm zone="courier couriertcpd">
     659            <primary sortas="b-couriertcpd">couriertcpd</primary>
     660          </indexterm>
     661        </listitem>
     662      </varlistentry>
     663
     664      <varlistentry id="couriertls">
     665        <term><command>couriertls</command></term>
     666        <listitem>
     667          <para>is used by applications to encrypt a network connection
     668          using SSL/TLS.</para>
     669          <indexterm zone="courier couriertls">
     670            <primary sortas="b-couriertls">couriertls</primary>
     671          </indexterm>
     672        </listitem>
     673      </varlistentry>
     674
     675      <varlistentry id="dotforward">
     676        <term><command>dotforward</command></term>
     677        <listitem>
     678          <para>is a compatibility module that reads forwarding
     679          instructions in <filename>$HOME/.forward</filename>.</para>
     680          <indexterm zone="courier dotforward">
     681            <primary sortas="b-dotforward">dotforward</primary>
     682          </indexterm>
     683        </listitem>
     684      </varlistentry>
     685
     686      <varlistentry id="dupfilter">
     687        <term><command>dupfilter</command></term>
     688        <listitem>
     689          <para>is a threaded filter that tries to block junk E-mail by
     690          attempting to detect multiple copies of the same message, which
     691          are rejected.</para>
     692          <indexterm zone="courier dupfilter">
     693            <primary sortas="b-dupfilter">dupfilter</primary>
     694          </indexterm>
     695        </listitem>
     696      </varlistentry>
     697
     698      <varlistentry id="esmtpd">
     699        <term><command>esmtpd</command></term>
     700        <listitem>
     701          <para>is a control script for courieresmtpd.</para>
     702          <indexterm zone="courier esmtpd">
     703            <primary sortas="b-esmtpd">esmtpd</primary>
     704          </indexterm>
     705        </listitem>
     706      </varlistentry>
     707
     708      <varlistentry id="esmtpd-msa">
     709        <term><command>esmtpd-msa</command></term>
     710        <listitem>
     711          <para>is a control script for courieresmtpd, but adds message
     712          submission port 587 for the MSA protocol.</para>
     713          <indexterm zone="courier esmtpd-msa">
     714            <primary sortas="b-esmtpd-msa">esmtpd-msa</primary>
     715          </indexterm>
     716        </listitem>
     717      </varlistentry>
     718
     719      <varlistentry id="filterctl">
     720        <term><command>filterctl</command></term>
     721        <listitem>
     722          <para>installs or uninstalls global mail filters.</para>
     723          <indexterm zone="courier filterctl">
     724            <primary sortas="b-filterctl">filterctl</primary>
     725          </indexterm>
     726        </listitem>
     727      </varlistentry>
     728
     729      <varlistentry id="imapd">
     730        <term><command>imapd</command></term>
     731        <listitem>
     732          <para>is the <application>Courier</application>-IMAP server.</para>
     733          <indexterm zone="courier imapd">
     734            <primary sortas="b-imapd">imapd</primary>
     735          </indexterm>
     736        </listitem>
     737      </varlistentry>
     738
     739      <varlistentry id="lockmail">
     740        <term><command>lockmail</command></term>
     741        <listitem>
     742          <para>is a helper utility for locking  mailbox files.</para>
     743          <indexterm zone="courier lockmail">
     744            <primary sortas="b-lockmail">lockmail</primary>
     745          </indexterm>
     746        </listitem>
     747      </varlistentry>
     748
     749      <varlistentry id="mailbot">
     750        <term><command>mailbot</command></term>
     751        <listitem>
     752          <para>is a MIME-aware autoresponder utility.</para>
     753          <indexterm zone="courier mailbot">
     754            <primary sortas="b-mailbot">mailbot</primary>
     755          </indexterm>
     756        </listitem>
     757      </varlistentry>
     758
     759      <varlistentry id="maildiracl">
     760        <term><command>maildiracl</command></term>
     761        <listitem>
     762          <para>manages access control lists.</para>
     763          <indexterm zone="courier maildiracl">
     764            <primary sortas="b-maildiracl">maildiracl</primary>
     765          </indexterm>
     766        </listitem>
     767      </varlistentry>
     768
     769      <varlistentry id="maildirkw">
     770        <term><command>maildirkw</command></term>
     771        <listitem>
     772          <para>modifies <application>Courier</application>-IMAP compatible
     773          maildir message keywords.</para>
     774          <indexterm zone="courier maildirkw">
     775            <primary sortas="b-maildirkw">maildirkw</primary>
     776          </indexterm>
     777        </listitem>
     778      </varlistentry>
     779
     780      <varlistentry id="maildirmake">
     781        <term><command>maildirmake</command></term>
     782        <listitem>
     783          <para>creates maildirs, and maildir folders.</para>
     784          <indexterm zone="courier maildirmake">
     785            <primary sortas="b-maildirmake">maildirmake</primary>
     786          </indexterm>
     787        </listitem>
     788      </varlistentry>
     789
     790      <varlistentry id="maildrop">
     791        <term><command>maildrop</command></term>
     792        <listitem>
     793          <para>is a replacement local mail delivery agent that includes a
     794          mail filtering language.</para>
     795          <indexterm zone="courier maildrop">
     796            <primary sortas="b-maildrop">maildrop</primary>
     797          </indexterm>
     798        </listitem>
     799      </varlistentry>
     800
     801      <varlistentry id="mailq-courier">
     802        <term><command>mailq</command></term>
     803        <listitem>
     804          <para>displays a list of all messages that have not been
     805          delivered yet.</para>
     806          <indexterm zone="courier mailq-courier">
     807            <primary sortas="b-mailq">mailq</primary>
     808          </indexterm>
     809        </listitem>
     810      </varlistentry>
     811
     812      <varlistentry id="makeacceptmailfor">
     813        <term><command>makeacceptmailfor</command></term>
     814        <listitem>
     815          <para>builds a list of domains to accept mail for, from the
     816          <filename class="directory">/etc/courier/esmtpacceptmailfor.dir</filename>
     817          directory.</para>
     818          <indexterm zone="courier makeacceptmailfor">
     819            <primary sortas="b-makeacceptmailfor">makeacceptmailfor</primary>
     820          </indexterm>
     821        </listitem>
     822      </varlistentry>
     823
     824      <varlistentry id="makealiases">
     825        <term><command>makealiases</command></term>
     826        <listitem>
     827          <para>builds an alias database from one or more plain text
     828          source files.</para>
     829          <indexterm zone="courier makealiases">
     830            <primary sortas="b-makealiases">makealiases</primary>
     831          </indexterm>
     832        </listitem>
     833      </varlistentry>
     834
     835      <varlistentry id="makedat">
     836        <term><command>makedat</command></term>
     837        <listitem>
     838          <para>is a utility to create <application>GDBM</application> or
     839          <application>DB</application> files from plain text files.</para>
     840          <indexterm zone="courier makedat">
     841            <primary sortas="b-makedat">makedat</primary>
     842          </indexterm>
     843        </listitem>
     844      </varlistentry>
     845
     846      <varlistentry id="makehosteddomains">
     847        <term><command>makehosteddomains</command></term>
     848        <listitem>
     849          <para>rebuilds the contents of the hosteddomains database from the
     850          contents of <filename>/etc/courier/hosteddomains</filename>.</para>
     851          <indexterm zone="courier makehosteddomains">
     852            <primary sortas="b-makehosteddomains">makehosteddomains</primary>
     853          </indexterm>
     854        </listitem>
     855      </varlistentry>
     856
     857      <varlistentry id="makemime">
     858        <term><command>makemime</command></term>
     859        <listitem>
     860          <para>creates MIME-formatted messages from one
     861          or more files.</para>
     862          <indexterm zone="courier makemime">
     863            <primary sortas="b-makemime">makemime</primary>
     864          </indexterm>
     865        </listitem>
     866      </varlistentry>
     867
     868      <varlistentry id="makepercentrelay">
     869        <term><command>makepercentrelay</command></term>
     870        <listitem>
     871          <para>builds a list of %-relayed domains from the
     872          <filename class="directory">percentrelay.dir</filename> directory.</para>
     873          <indexterm zone="courier makepercentrelay">
     874            <primary sortas="b-makepercentrelay">makepercentrelay</primary>
     875          </indexterm>
     876        </listitem>
     877      </varlistentry>
     878
     879      <varlistentry id="makesmtpaccess">
     880        <term><command>makesmtpaccess</command></term>
     881        <listitem>
     882          <para>builds ESMTP server access files from the
     883          <filename class="directory">/etc/courier/smtpaccess</filename>
     884          directory.</para>
     885          <indexterm zone="courier makesmtpaccess">
     886            <primary sortas="b-makesmtpaccess">makesmtpaccess</primary>
     887          </indexterm>
     888        </listitem>
     889      </varlistentry>
     890
     891      <varlistentry id="makesmtpaccess-msa">
     892        <term><command>makesmtpaccess-msa</command></term>
     893        <listitem>
     894          <para>builds ESMTP server access files from the
     895          <filename class="directory">/etc/courier/smtpaccess</filename>
     896          directory. This esmtp list is for the MSA protocol.</para>
     897          <indexterm zone="courier makesmtpaccess-msa">
     898            <primary sortas="b-makesmtpaccess-msa">makesmtpaccess-msa</primary>
     899          </indexterm>
     900        </listitem>
     901      </varlistentry>
     902
     903      <varlistentry id="makeuserdb">
     904        <term><command>makeuserdb</command></term>
     905        <listitem>
     906          <para>builds a user/password db from the contents of <filename
     907          class="directory">/etc/courier/userdb</filename>.</para>
     908          <indexterm zone="courier makeuserdb">
     909            <primary sortas="b-makeuserdb">makeuserdb</primary>
     910          </indexterm>
     911        </listitem>
     912      </varlistentry>
     913
     914      <varlistentry id="mimegpg">
     915        <term><command>mimegpg</command></term>
     916        <listitem>
     917          <para>signs, encrypts, or decrypts MIME-formatted
     918          email messages using <application>GnuPG</application>.</para>
     919          <indexterm zone="courier mimegpg">
     920            <primary sortas="b-mimegpg">mimegpg</primary>
     921          </indexterm>
     922        </listitem>
     923      </varlistentry>
     924
     925      <varlistentry id="mkesmtpdcert">
     926        <term><command>mkesmtpdcert</command></term>
     927        <listitem>
     928          <para>creates a secure SMTP test certificate.</para>
     929          <indexterm zone="courier mkesmtpdcert">
     930            <primary sortas="b-mkesmtpdcert">mkesmtpdcert</primary>
     931          </indexterm>
     932        </listitem>
     933      </varlistentry>
     934
     935      <varlistentry id="mkimapdcert">
     936        <term><command>mkimapdcert</command></term>
     937        <listitem>
     938          <para>creates a secure IMAP test certificate.</para>
     939          <indexterm zone="courier mkimapdcert">
     940            <primary sortas="b-mkimapdcert">mkimapdcert</primary>
     941          </indexterm>
     942        </listitem>
     943      </varlistentry>
     944
     945      <varlistentry id="mkpop3dcert">
     946        <term><command>mkpop3dcert</command></term>
     947        <listitem>
     948          <para>creates a secure POP3 test certificate.</para>
     949          <indexterm zone="courier mkpop3dcert">
     950            <primary sortas="b-mkpop3dcert">mkpop3dcert</primary>
     951          </indexterm>
     952        </listitem>
     953      </varlistentry>
     954
     955      <varlistentry id="pop3d">
     956        <term><command>pop3d</command></term>
     957        <listitem>
     958          <para>is a wrapper script for <command>couriertcpd</command> to
     959          start and stop the POP3 service.</para>
     960          <indexterm zone="courier pop3d">
     961            <primary sortas="b-pop3d">pop3d</primary>
     962          </indexterm>
     963        </listitem>
     964      </varlistentry>
     965
     966      <varlistentry id="pop3d-ssl">
     967        <term><command>pop3d-ssl</command></term>
     968        <listitem>
     969          <para>is a wrapper script for <command>couriertcpd</command> to
     970          start and stop the POP3 over SSL service.</para>
     971          <indexterm zone="courier pop3d-ssl">
     972            <primary sortas="b-pop3d-ssl">pop3d-ssl</primary>
     973          </indexterm>
     974        </listitem>
     975      </varlistentry>
     976
     977      <varlistentry id="preline">
     978        <term><command>preline</command></term>
     979        <listitem>
     980          <para>prepends legacy <filename>mbox</filename> headers to mail
     981          messages.</para>
     982          <indexterm zone="courier preline">
     983            <primary sortas="b-preline">preline</primary>
     984          </indexterm>
     985        </listitem>
     986      </varlistentry>
     987
     988      <varlistentry id="reformail">
     989        <term><command>reformail</command></term>
     990        <listitem>
     991          <para>reads a message on standard input, reformats it in some
     992          way, and writes the message to standard output.</para>
     993          <indexterm zone="courier reformail">
     994            <primary sortas="b-reformail">reformail</primary>
     995          </indexterm>
     996        </listitem>
     997      </varlistentry>
     998
     999      <varlistentry id="reformime">
     1000        <term><command>reformime</command></term>
     1001        <listitem>
     1002          <para>is a utility for reformatting MIME messages.</para>
     1003          <indexterm zone="courier reformime">
     1004            <primary sortas="b-reformime">reformime</primary>
     1005          </indexterm>
     1006        </listitem>
     1007      </varlistentry>
     1008
     1009      <varlistentry id="sendmail-courier">
     1010        <term><command>sendmail</command></term>
     1011        <listitem>
     1012          <para>reads an email message and delivers the message to its
     1013          recipients.</para>
     1014          <indexterm zone="courier sendmail-courier">
     1015            <primary sortas="b-sendmail">sendmail</primary>
     1016          </indexterm>
     1017        </listitem>
     1018      </varlistentry>
     1019
     1020      <varlistentry id="submit">
     1021        <term><command>submit</command></term>
     1022        <listitem>
     1023          <para>submits messages to <application>Courier</application> for
     1024          processing.</para>
     1025          <indexterm zone="courier submit">
     1026            <primary sortas="b-submit">submit</primary>
     1027          </indexterm>
     1028        </listitem>
     1029      </varlistentry>
     1030
     1031      <varlistentry id="testmxlookup">
     1032        <term><command>testmxlookup</command></term>
     1033        <listitem>
     1034          <para>lists the names and IP addresses of mail
     1035          relays that receive mail for the domain.</para>
     1036          <indexterm zone="courier testmxlookup">
     1037            <primary sortas="b-testmxlookup">testmxlookup</primary>
     1038          </indexterm>
     1039        </listitem>
     1040      </varlistentry>
     1041
     1042      <varlistentry id="userdb">
     1043        <term><command>userdb</command></term>
     1044        <listitem>
     1045          <para>is a script to individually manipulate entries in
     1046          <filename>/etc/courier/userdb.</filename></para>
     1047          <indexterm zone="courier userdb">
     1048            <primary sortas="b-userdb">userdb</primary>
     1049          </indexterm>
     1050        </listitem>
     1051      </varlistentry>
     1052
     1053      <varlistentry id="userdbpw">
     1054        <term><command>userdbpw</command></term>
     1055        <listitem>
     1056          <para>reads a single line of text on standard input, encrypts
     1057          it, and prints the encrypted result to standard output.</para>
     1058          <indexterm zone="courier userdbpw">
     1059            <primary sortas="b-userdbpw">userdbpw</primary>
     1060          </indexterm>
     1061        </listitem>
     1062      </varlistentry>
     1063
     1064    </variablelist>
     1065
     1066  </sect2>
    9501067
    9511068</sect1>
    952 
Note: See TracChangeset for help on using the changeset viewer.