Ignore:
Timestamp:
01/16/2005 07:55:10 PM (19 years ago)
Author:
DJ Lucas <dj@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 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:
6893009c
Parents:
0962a5b
Message:

Updated to courier 0.47

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/mail/courier.xml

    r0962a5b rebe1291  
    77<!ENTITY courier-download-http "http://prdownloads.sourceforge.net/courier/courier-&courier-version;.tar.bz2">
    88<!ENTITY courier-download-ftp " ">
    9 <!ENTITY courier-size "4.2 MB">
    10 <!ENTITY courier-buildsize "114 MB">
    11 <!ENTITY courier-time "3.00 SBU">
     9<!ENTITY courier-size "4.3 MB">
     10<!ENTITY courier-buildsize "102 MB">
     11<!ENTITY courier-time "2.62 SBU">
    1212
    1313]>
    1414
    15 <sect1 id="courier" xreflabel="Courier-&courier-version;">
     15<sect1 id="courier-package" xreflabel="Courier-&courier-version;">
    1616<sect1info>
    1717<othername>$LastChangedBy$</othername>
    … …  
    2020<?dbhtml filename="courier.html"?>
    2121<title>Courier-&courier-version;</title>
     22<indexterm zone="courier-package">
     23<primary sortas="a-courier-package">Courier MTA</primary></indexterm>
    2224
    2325<sect2>
    … …  
    3133<acronym>IMAP</acronym>-<acronym>SSL</acronym>, <acronym>POP</acronym>3, and
    3234<acronym>POP</acronym>3-<acronym>SSL</acronym>.</para>
    33 
    34 <!--
    35 The configuration
    36 listed below will allow users with <acronym>PAM</acronym> and virtual-users in
    37 a <application>My<acronym>SQL</acronym></application> Database access to email.</para>
    38 -->
    3935
    4036<sect3><title>Package information</title>
    … …  
    5349<sect3><title><application>Courier</application> dependencies</title>
    5450<sect4><title>Required</title>
    55 <para><xref linkend="gdbm"/><!-- or <xref linkend="db"/> --></para>
     51<para><xref linkend="gdbm"/></para>
    5652</sect4>
    5753<sect4><title>Optional</title>
    … …  
    6561<xref linkend="gnupg"/>,
    6662<xref linkend="expect"/>,
     63<xref linkend="gs"/> or <xref linkend="espgs"/>,
    6764<ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink> and
    6865<ulink url="http://alpha.greenie.net/mgetty/">Mgetty+Sendfax</ulink>
    … …  
    7471<sect2>
    7572<title>Installation of <application>Courier</application></title>
    76 
    77 <para> Before you compile the program, you need to create users and groups that
    78 will be expected to be in place when the install script executes. Add the users
    79 and groups with the following commands:</para>
     73<note><para><application>Courier's</application> tarball must be extacted as an
     74unpriveleged user or configure will fail.</para></note>
     75
     76<para>After extracting the tarball, you'll need to <command>su</command> to
     77user 'root' in order to perform the next few steps.</para>
     78 
     79<para> Before you compile the program, you need to create the courier user
     80and group that is expected to be in place when the install script executes.
     81Add the courier user and group with the following commands:</para>
    8082
    8183<screen><userinput><command>groupadd courier &amp;&amp;
    … …  
    8385        -g courier -s /bin/false courier</command></userinput></screen>
    8486
    85 <para> You also need to create a bin user. If you already have a user
     87<para>The install script also expects a bin user. If you already have a user
    8688named bin, this step can be safely ignored.</para>
    8789
    8890<screen><userinput><command>useradd -c 'bin' -d /dev/null -g bin -u 1 bin</command></userinput></screen>
    8991
    90 <para>This creates a
    91 <filename class="directory">/var/run/courier</filename> directory where
    92 all the <application>Courier</application> <acronym>MTA</acronym> pid
    93 files will exist. This will allow <filename>courierfilter.pid</filename>
    94 to be created. Without the <command>courierfilter</command> running, the
    95 <application>Courier</application> MTA will not work. Issue the
    96 following commands to create
    97 <filename class="directory">/var/run/courier</filename>:</para>
    98 
    99 <screen><userinput><command>mkdir /var/run/courier &amp;&amp;
    100 chown courier:courier /var/run/courier</command></userinput></screen>
    101 
    102 <para>Install <application>courier</application> by running the following
    103 commands:</para>
     92<para><application>Courierfilter</application> requires the directory
     93<filename class="directory">/var/run/courier</filename> to store
     94all the <application>Courier</application> pid and lockfiles. 
     95<filename class="directory">/var/lock/subsys</filename> also must exist
     96for the master lock file for <application>Courier</application>. Issue
     97the following commands to create these directories:</para>
     98
     99<screen><userinput><command>install -d /var/run/courier -o courier -g courier -m755 &amp;&amp;
     100install -d /var/lock/subsys -o root -g root -m755</command></userinput></screen>
     101
     102<para>Build <application>courier</application> as an unpriveledged user
     103with the following commands:</para>
    104104
    105105<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib/courier \
    … …  
    110110    --with-paranoid-smtpext --disable-autorenamesent \
    111111    --enable-workarounds-for-imap-client-bugs --with-db=gdbm &amp;&amp;
    112 make &amp;&amp;
    113 make install &amp;&amp;
     112make</command></userinput></screen>
     113
     114<para><command>su</command> once again to user 'root' and install
     115<application>courier</application> with the following commands:</para>
     116
     117<screen><userinput><command>make install &amp;&amp;
    114118make install-configure</command></userinput></screen>
    115119
    … …  
    180184<application>DB</application> database library.
    181185<application><acronym>GDBM</acronym></application> is used if both are
    182 present. This option forces the selection of the GDBM database
    183 library since support for DB is broken at the current state.</para>
     186present. This option forces the selection of
     187<application>GDBM</application> as courier is currently broken when used
     188with <application>DB</application>.</para>
    184189
    185190<!-- # Note - Courier will build fine with <xref linkend="db"/>, but all
    … …  
    198203</sect2>
    199204
    200 <sect2>
     205<sect2 id="courier-config">
    201206<title>Configuring <application>Courier</application></title>
    202 
    203 <sect3><title>Config files</title>
    204 <para><filename>/etc/courier/*</filename></para>
     207<indexterm zone="courier-package courier-config">
     208<primary sortas="e-courier-config">/etc/courier/*</primary></indexterm>
     209
     210<sect3><title>Configuration Information</title>
     211
     212<para>You will need to <command>su</command> to user 'root' for the
     213remainder of the configuration.</para>
     214
     215<para>You will need to create the following files with the contents
     216specified.</para>
     217
     218<para><filename>/etc/courier/defaultdomain</filename></para>
     219
     220<screen><userinput><command>cat &gt; /etc/courier/defaultdomain &lt;&lt; "EOF"</command>
     221<replaceable>[yourdomain]</replaceable>
     222<command>EOF</command></userinput></screen>
     223
     224<para><filename>/etc/courier/me</filename></para>
     225
     226<screen><userinput><command>cat &gt; /etc/courier/me &lt;&lt; "EOF"</command>
     227<replaceable>[servername.yourdomain]</replaceable>
     228<command>EOF</command></userinput></screen>
     229
     230<para><filename>/etc/courier/locals</filename></para>
     231
     232<screen><userinput><command>cat &gt; /etc/courier/locals &lt;&lt; "EOF"</command>
     233localhost
     234<replaceable>[yourdomain]</replaceable>
     235<command>EOF</command></userinput></screen>
     236
     237<para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
     238
     239<screen><userinput><command>cat
     240&gt;/etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"</command>
     241localhost
     242<replaceable>[yourdomain]</replaceable>
     243<command>EOF</command></userinput></screen>
     244
     245<para>You will also need to edit the aliases file and change the
     246following entry.</para>
     247
     248<para><filename>/etc/courier/aliases/system</filename></para>
     249
     250<screen><userinput>postmaster: <replaceable>[your administrator email]</replaceable></userinput></screen>
     251
     252<para>If you want to deny access from some hosts from sending mail, you
     253will need to edit the
     254<filename>/etc/courier/smtpaccess/default</filename> file.</para>
     255
     256<para>If you wish to host mail for non local domains including virtual
     257domains,
     258you must add them to <filename>/etc/courier/hosteddomains</filename>.
     259This
     260file should exist wether you need a hosted domain list or not:</para>
     261
     262<para><screen><userinput>touch
     263/etc/courier/hosteddomains</userinput></screen></para>
     264
     265<para>After the above steps are completed you will need to run the
     266following commands:</para>
     267
     268<screen><userinput><command>makesmtpaccess &amp;&amp;
     269makehosteddomains &amp;&amp;
     270makealiases</command></userinput></screen>
     271
     272<para>For each user, you will need to create a
     273<filename class="directory">Maildir</filename> directory:</para>
     274
     275<screen><userinput><command>cd /home/<replaceable>[username]</replaceable> &amp;&amp;
     276maildirmake Maildir &amp;&amp;
     277chown <replaceable>[username]</replaceable>.<replaceable>[username]</replaceable> Maildir -R</command></userinput></screen>
     278
     279<para>If you wish to use <acronym>SSL</acronym> with
     280<application>Courier</application>, you should obtain certificates and
     281store them in <filename>/usr/share/courier</filename>.  You can
     282optionally create self-signed, test certificates with the following
     283commands:</para>
     284
     285<screen><userinput><command>mkesmtpdcert &amp;&amp;
     286mkimapdcert &amp;&amp;
     287mkpop3dcert</command></userinput></screen>
     288
     289<para>All of courier's configuration files reside in the directory
     290<filename class="directory">/etc/courier/</filename>.  For each service
     291<acronym>SMTP</acronym>, <acronym>POP3</acronym> and
     292<acronym>IMAP</acronym>, you will have a standard config file, and an
     293<acronym>SSL</acronym> config file.  For each service that you
     294wish to utilize, you will need to edit the configuration file, and
     295change the <replaceable>[DAEMON]</replaceable>START variable from 'NO' to
     296'YES'.  For example, to use <acronym>SMTP</acronym> with
     297<acronym>SSL</acronym>, you'll need to edit
     298<filename>/etc/courier/esmtpd-ssl</filename> and change the value of
     299'ESMTPDSSLSTART' to 'YES'.  Make the same change for each service
     300configuration that you wish to use with
     301<application>courier</application>.</para>
     302
     303<para>If you wish to use <acronym>LDAP</acronym>, an
     304<acronym>LDAP</acronym> configuration file should be created:</para>
     305
     306<screen><userinput><command>echo "LDAPALIASDSTART=YES" > /etc/courier/ldapaliasd</command></userinput></screen>
     307
     308<para>Similarly, if you wish to use webmail, you should create the webmail
     309configuration file:</para>
     310
     311<screen><userinput><command>echo "WEBMAILDSTART=YES" > /etc/courier/webmaild</command></userinput></screen>
     312
     313<para>You will also need to copy the <filename>webmail</filename> file from
     314<filename>/usr/lib/courier/courier/webmail</filename> to your <filename>cgi-bin
     315</filename> directory of your <application>Apache</application>
     316server.</para>
     317
     318<screen><userinput><command>cp -a /usr/lib/courier/courier/webmail/webmail /srv/www/cgi-bin</command></userinput></screen>
     319
     320<para>You will then need to copy the images to a directory under your
     321<filename>htdocs</filename> directory of your
     322<application>Apache</application> server. The directory needs to be named
     323<filename>webmail</filename> or you need to specify it during the configure
     324phase with <parameter>--enable-imageurl=<replaceable>[URL]</replaceable></parameter>.</para>
     325
     326<screen><userinput><command>cp -a /usr/share/courier/sqwebmail/images /srv/www/htdocs/webmail</command></userinput></screen>
     327<para><emphasis>Setup for Web-based Email</emphasis></para>
     328
     329<para>If you wish to utilze the webadmin utility, you will need to copy the
     330<filename>webadmin</filename> file from
     331<filename class="directory">/usr/lib/courier/courier/webmail</filename>
     332to your <filename class="directory">cgi-bin</filename> directory of your
     333<application>Apache</application> server.</para>
     334
     335<screen><userinput><command>cp -a /usr/lib/courier/courier/webmail/webadmin /srv/www/cgi-bin</command></userinput></screen>
     336
     337<para><filename>/etc/courier/webadmin/password</filename></para>
     338
     339<screen><userinput><command>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"</command>
     340<replaceable>[password]</replaceable>
     341<command>EOF</command></userinput></screen>
     342
     343<para>If you are not using <acronym>SSL</acronym> on your <application>Apache
     344</application> server, you will also need to add
     345<filename>/etc/courier/webadmin/unsecureok</filename>, so you will be able
     346to use your web based administration tool.</para>
     347
     348<screen><userinput><command>touch /etc/courier/webadmin/unsecureok</command></userinput></screen>
     349
     350<para>If you use <application>LinuxPAM</application> on your system,
     351you will need to create the <acronym>PAM</acronym> configuration files:</para>
     352
     353<screen><userinput><command>cat &gt; /etc/pam.d/esmtp &lt;&lt;
     354"EOF"</command>
     355# Begin /etc/pam.d/esmtp
     356
     357auth            required                pam_unix.so try_first_pass
     358account         required                pam_unix.so
     359session         required                pam_unix.so
     360
     361# End /etc/pam.d/esmtp
     362<command>EOF
     363cat &gt; /etc/pam.d/pop3 &lt;&lt; "EOF"</command>
     364# Begin /etc/pam.d/pop3
     365
     366auth            required                pam_unix.so try_first_pass
     367account         required                pam_unix.so
     368session         required                pam_unix.so
     369
     370# End /etc/pam.d/pop3
     371<command>EOF
     372cat &gt; /etc/pam.d/imap &lt;&lt; "EOF"</command>
     373# Begin /etc/pam.d/imap
     374
     375auth            required                pam_unix.so try_first_pass
     376account         required                pam_unix.so
     377session         required                pam_unix.so
     378
     379# End /etc/pam.d/imap
     380<command>EOF
     381cat &gt; /etc/pam.d/webmail &lt;&lt; "EOF"</command>
     382# Begin /etc/pam.d/webmail
     383
     384auth            required                pam_unix.so try_first_pass
     385account         required                pam_unix.so
     386session         required                pam_unix.so
     387
     388# End /etc/pam.d/webmail
     389<command>EOF</command></userinput></screen>
     390
     391<para id="courier-init">Finaly, if you wish to start courier at boot, install
     392the <filename>/etc/rc.d/init.d/courier</filename> bootscript included in the
     393<xref linkend="intro-important-bootscripts"/> package.</para>
     394<indexterm zone="courier-package courier-init">
     395<primary sortas="f-courier-init">courier</primary></indexterm>
     396
     397<screen><userinput><command>make install-courier</command></userinput></screen>
     398
    205399</sect3>
    206400
    207 <sect3><title>Configuration Information</title>
    208 
    209 <para>Make the following changes in
    210 <filename>/etc/courier/authmysqlrc</filename> file if you are utilizing
    211 <application>My<acronym>SQL</acronym></application>:</para>
     401<!-- Begin virtual user setup * To be removed once added to the hint. -->
     402
     403<sect3>
     404
     405<title>Configuring for virtual users</title>
     406
     407<para>These instructions will configure <application>courier</application>
     408to lookup virtual users in a <application>MySQL</application> database.
     409Begin by making the following changes to
     410<filename>/etc/courier/authmysqlrc</filename>:</para>
    212411
    213412<screen><userinput>MYSQL_SERVER            localhost
    214413MYSQL_USERNAME          courier
    215 MYSQL_PASSWORD          <replaceable>[your choice]</replaceable> 
     414MYSQL_PASSWORD          <replaceable>[your choice]</replaceable>
    216415MYSQL_SOCKET            /tmp/mysql.sock
    217416MYSQL_PORT              3306
    … …  
    222421MYSQL_QUOTA_FIELD       quota</userinput></screen>
    223422
    224 <para>If you utilize <application>PAM</application>:</para>
    225 
    226 <screen><userinput><command>cat &gt; /etc/pam.d/esmtp &lt;&lt; "EOF"</command>
    227 # Begin /etc/pam.d/esmtp
    228 
    229 auth            required                pam_unix.so try_first_pass
    230 account         required                pam_unix.so
    231 session         required                pam_unix.so
    232 
    233 # End /etc/pam.d/esmtp
    234 <command>EOF
    235 cat &gt; /etc/pam.d/pop3 &lt;&lt; "EOF"</command>
    236 # Begin /etc/pam.d/pop3
    237 
    238 auth            required                pam_unix.so try_first_pass
    239 account         required                pam_unix.so
    240 session         required                pam_unix.so
    241 
    242 # End /etc/pam.d/pop3
    243 <command>EOF
    244 cat &gt; /etc/pam.d/imap &lt;&lt; "EOF"</command>
    245 # Begin /etc/pam.d/imap
    246 
    247 auth            required                pam_unix.so try_first_pass
    248 account         required                pam_unix.so
    249 session         required                pam_unix.so
    250 
    251 # End /etc/pam.d/imap
    252 <command>EOF
    253 cat &gt; /etc/pam.d/webmail &lt;&lt; "EOF"</command>
    254 # Begin /etc/pam.d/webmail
    255 
    256 auth            required                pam_unix.so try_first_pass
    257 account         required                pam_unix.so
    258 session         required                pam_unix.so
    259 
    260 # End /etc/pam.d/webmail
    261 <command>EOF</command></userinput></screen>
    262 
    263 <para>Connect to the <application>My<acronym>SQL</acronym></application>
    264 database:</para>
     423<para>Connect to <application>MySQL</application>:</para>
    265424
    266425<screen><userinput><command>mysql -p</command></userinput></screen>
    267426
    268 <para>This command will create the database for authentication:</para>
     427<para>Create the <filename>courier_mail</filename> database and setup
     428the users table:</para>
    269429
    270430<screen><userinput><command>CREATE DATABASE courier_mail;
    271 USE courier_mail</command></userinput></screen>
    272 
    273 <para>This command will setup the table users for the courier_mail
    274 database:</para>
    275 
    276 <screen><userinput><command>CREATE TABLE users (
     431USE courier_mail
     432CREATE TABLE users (
    277433id                    char(128) DEFAULT '' NOT NULL,
    278434crypt                 char(128) DEFAULT '' NOT NULL,
    … …  
    286442);</command></userinput></screen>
    287443
    288 <para>This will add the courier user that we specified earlier in the
    289 <filename>/etc/courier/authmysqlrc</filename> file:</para>
     444<para>Grant all priveledges to the courier user created earlier:</para>
    290445
    291446<screen><userinput><command>GRANT ALL PRIVILEGES ON *.* TO courier@localhost \
    … …  
    293448QUIT</command></userinput></screen>
    294449
    295 <para><emphasis>General Settings for Mail</emphasis></para>
    296 
    297 <para>You will need to create the following files with the contents
    298 specified.</para>
    299 
    300 <para><filename>/etc/courier/defaultdomain</filename></para>
    301 
    302 <screen><userinput><command>cat &gt; /etc/courier/defaultdomain &lt;&lt; "EOF"</command>
    303 <replaceable>[yourdomain]</replaceable>
    304 <command>EOF</command></userinput></screen>
    305 
    306 <para><filename>/etc/courier/me</filename></para>
    307 
    308 <screen><userinput><command>cat &gt; /etc/courier/me &lt;&lt; "EOF"</command>
    309 <replaceable>[servername.yourdomain]</replaceable>
    310 <command>EOF</command></userinput></screen>
    311 
    312 <para><filename>/etc/courier/locals</filename></para>
    313 
    314 <screen><userinput><command>cat &gt; /etc/courier/locals &lt;&lt; "EOF"</command>
    315 localhost
    316 <replaceable>[yourdomain]</replaceable>
    317 <command>EOF</command></userinput></screen>
    318 
    319 <para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
    320 
    321 <screen><userinput><command>cat &gt;/etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"</command>
    322 localhost
    323 <replaceable>[yourdomain]</replaceable>
    324 <command>EOF</command></userinput></screen>
    325 
    326 <para>You will also need to edit the aliases file and change the
    327 following entry.</para>
    328 
    329 <para><filename>/etc/courier/aliases/system</filename></para>
    330 
    331 <screen><userinput>postmaster: <replaceable>[your administrator email]</replaceable></userinput></screen>
    332 
    333 <para>If you want to deny access from some hosts from sending mail, you
    334 will need to edit the
    335 <filename>/etc/courier/smtpaccess/default</filename> file.</para>
    336 
    337 <para>After the above steps are completed you will need to run the
    338 following commands:</para>
    339 
    340 <screen><userinput><command>makesmtpaccess &amp;&amp;
    341 makehosteddomains &amp;&amp;
    342 makealiases</command></userinput></screen>
    343 
    344 <para><emphasis><acronym>SMTP</acronym>/<acronym>SMTMP</acronym>-<acronym>SSL
    345 </acronym> Configuration</emphasis></para>
    346 
    347 <para>This section will enable the <acronym>SMTP</acronym> Server from Courier</para>
    348 
    349 <para><filename>/etc/courier/esmtpd</filename></para>
    350 
    351 <screen><userinput>ESMTPDSTART=YES</userinput></screen>
    352 
    353 <para><filename>/etc/courier/esmtpd-ssl</filename></para>
    354 
    355 <screen><userinput>ESMTPDSSLSTART=YES</userinput></screen>
    356 
    357 <para><emphasis><acronym>POP</acronym>3/<acronym>POP</acronym>3-<acronym>SSL
    358 </acronym> Configuration</emphasis></para>
    359 
    360 <para>This section will enable the <acronym>POP</acronym>3 Server from
    361 Courier</para>
    362 
    363 
    364 <para><filename>/etc/courier/pop3d</filename></para>
    365 
    366 <screen><userinput>POP3DSTART=YES</userinput></screen>
    367 
    368 <para><filename>/etc/courier/pop3d-ssl</filename></para>
    369 
    370 <screen><userinput>POP3DSLLSTART=YES</userinput></screen>
    371 
    372 <para><emphasis><acronym>IMAP</acronym>/<acronym>IMAP</acronym>-<acronym>SSL
    373 </acronym> Configuration</emphasis></para>
    374 
    375 <para>This section will enable the <acronym>IMAP</acronym> Server from
    376 Courier</para>
    377 
    378 <para><filename>/etc/courier/imapd</filename></para>
    379 
    380 
    381 <screen><userinput>IMAPDSTART=YES</userinput></screen>
    382 
    383 <para><filename>/etc/courierd/imapd-ssl</filename></para>
    384 
    385 <screen><userinput>IMAPDSSLSTART=YES</userinput></screen>
    386 
    387 <para><emphasis>Creating Mail directories for System Users</emphasis></para>
    388 
    389 
    390 <para>This section will explain how to create MailDirs for
    391 your system users.</para>
    392 
    393 <screen><userinput><command>cd /home/<replaceable>[username]</replaceable> &amp;&amp;
    394 maildirmake Maildir &amp;&amp;
    395 chown <replaceable>[username]</replaceable>.<replaceable>[username]</replaceable> Maildir -R</command></userinput></screen>
    396 
    397 <para><emphasis>Setup for Virtual users</emphasis></para>
    398 
    399 <para>This section will explain how to setup Maildir for your virtual
    400 users.</para>
    401 
     450<para>Create a virtual mailman user and group:</para>
    402451<screen><userinput><command>groupadd -g 9000 vmailman &amp;&amp;
    403452useradd -c 'Virtual Mailman' -g vmailman -m -k /dev/null -u 9000 vmailman</command></userinput></screen>
    404453
    405 <para>Now to setup the Maildir for these virtual users.</para>
     454<para>Create a mail directory for a new virtual user:</para>
    406455
    407456<screen><userinput><command>cd /home/vmailman &amp;&amp;
    … …  
    411460chown vmailman.vmailman Maildir -R</command></userinput></screen>
    412461
    413 <para>Connect to the <application>My<acronym>SQL</acronym></application>
    414 database.</para>
     462<para>Now, connect the the <application>MySQL</application> database as
     463the courier user:</para>
    415464
    416465<screen><userinput><command>mysql -u courier -p</command></userinput></screen>
    417    
    418 <para>To add the virtual user you need to enter at
    419 least one version of the password either clear text or encrypted.</para>
     466
     467<para>To add the virtual user you need to enter at least one version of the
     468password either clear text or encrypted.</para>
     469
     470<para>Add the first virtual user with the following commands:</para>
    420471
    421472<screen><userinput><command>USE courier_mail
    … …  
    445496);</command></userinput></screen>
    446497
    447 <para><emphasis>Setup for Web-based Email</emphasis></para>
    448 
    449 <para>This section will explain how to setup Courier Web-based email
    450 system.</para>
    451 
    452 <para>You will need to copy the <filename>webmail</filename> file from
    453 <filename>/usr/lib/courier/courier/webmail</filename> to your <filename>cgi-bin
    454 </filename> directory of your <application>Apache</application>
    455 server.</para>
    456 
    457 <screen><userinput><command>cp -a /usr/lib/courier/courier/webmail/webmail /var/www/cgi-bin</command></userinput></screen>
    458 
    459 <para>You will then need to copy the images to a directory under your
    460 <filename>htdocs</filename> directory of your
    461 <application>Apache</application> server. The directory needs to be named
    462 <filename>webmail</filename> or you need to specify it during the configure
    463 phase with <parameter>--enable-imageurl=<replaceable>[URL]</replaceable></parameter>.</para>
    464 
    465 <screen><userinput><command>cp -a /usr/share/courier/sqwebmail/images /var/www/htdocs/webmail</command></userinput></screen>
    466 <para><emphasis>Setup for Web-based Email</emphasis></para>
    467 
    468 <para>This section will explain how to setup Courier Web-based administration
    469 system.</para>
    470 
    471 <para>You will need to copy the <filename>webadmin</filename> file from
    472 <filename class="directory">/usr/lib/courier/courier/webmail</filename>
    473 to your <filename class="directory">cgi-bin</filename> directory of your
    474 <application>Apache</application> server.</para>
    475 
    476 <screen><userinput><command>cp -a /usr/lib/courier/courier/webmail/webadmin /var/www/cgi-bin</command></userinput></screen>
    477 
    478 <para><filename>/etc/courier/webadmin/password</filename></para>
    479 
    480 <screen><userinput><command>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"</command>
    481 <replaceable>[password]</replaceable>
    482 <command>EOF</command></userinput></screen>
    483 
    484 <para>If you are not using <acronym>SSL</acronym> on your <application>Apache
    485 </application> server, you will need to add
    486 <filename>/etc/courier/webadmin/unsecureok</filename>, so you will be able
    487 to use your web based administration tool.</para>
    488 
    489 <screen><userinput><command>touch /etc/courier/webadmin/unsecureok</command></userinput></screen>
    490498</sect3>
    491499
    492 <sect3><title>Courier init.d script</title>
    493 
    494 <para>The startup script from the <application>Courier</application> package is
    495 the easiest to use. It will automatically create missing data files, and
    496 <acronym>SSL</acronym> certificates if they are missing. To install the
    497 init.d file for <application>Courier</application>, you will need to use the
    498 following commands:</para>
    499 
    500 <screen><userinput><command>cp /usr/src/courier-&courier-version;/courier.sysvinit /etc/rc.d/init.d/courier &amp;&amp;
    501 chmod 754 /etc/rc.d/init.d/courier</command></userinput></screen>
    502 
    503 <para>Create the symbolic links to this file in the relevant
    504 <filename>rc.d</filename> directory with the following commands:</para>
    505 
    506 <screen><userinput><command>cd /etc/rc.d/init.d &amp;&amp;
    507 ln -sf ../init.d/courier ../rc0.d/K25courier &amp;&amp;
    508 ln -sf ../init.d/courier ../rc1.d/K25courier &amp;&amp;
    509 ln -sf ../init.d/courier ../rc2.d/K25courier &amp;&amp;
    510 ln -sf ../init.d/courier ../rc3.d/S35courier &amp;&amp;
    511 ln -sf ../init.d/courier ../rc4.d/S35courier &amp;&amp;
    512 ln -sf ../init.d/courier ../rc5.d/S35courier &amp;&amp;
    513 ln -sf ../init.d/courier ../rc6.d/K25courier</command></userinput></screen>
    514 
    515 </sect3>
     500<!-- End of Virtual user setup  -->
     501
    516502</sect2>
    517503
    … …  
    519505<title>Contents</title>
    520506
    521 <para>The <application>Courier</application> package contains
    522 <command>addcr</command>,
    523 <command>authenumerate</command>,
    524 <command>cancelmsg</command>,
    525 <command>courier</command>,
    526 <command>courier-config</command>,
    527 <command>courieresmtpd</command>,
    528 <command>courierfilter</command>,
    529 <command>courierldapaliasd</command>,
    530 <command>courierlogger</command>,
    531 <command>couriermlm</command>,
    532 <command>couriertcpd</command>,
    533 <command>couriertls</command>,
    534 <command>deliverquota</command>,
    535 <command>dotforward</command>,
    536 <command>esmtpd</command>,
    537 <command>esmtpd-msa</command>,
    538 <command>esmtpd-ssl</command>,
    539 <command>filterctl</command>,
    540 <command>imapd</command>,
    541 <command>imapd</command>,
    542 <command>imapd-ssl</command>,
    543 <command>lockmail</command>,
    544 <command>mailbot</command>,
    545 <command>maildiracl</command>,
    546 <command>maildirkw</command>,
    547 <command>maildirmake</command>,
    548 <command>maildrop</command>,
    549 <command>makeacceptmailfor</command>,
    550 <command>makealiases</command>,
    551 <command>makedat</command>,
    552 <command>makehosteddomains</command>,
    553 <command>makemime</command>,
    554 <command>makepercentrelay</command>,
    555 <command>makesmtpaccess</command>,
    556 <command>makesmtpaccess-msa</command>,
    557 <command>makeuserdb</command>,
    558 <command>makeuucpneighbors</command>,
    559 <command>mimegpg</command>,
    560 <command>mkesmtpdcert</command>,
    561 <command>mkimapdcert</command>,
    562 <command>mkpop3dcert</command>,
    563 <command>pop3d</command>,
    564 <command>pop3d-ssl</command>,
    565 <command>preline</command>,
    566 <command>pw2userdb</command>,
    567 <command>reformail</command>,
    568 <command>reformime</command>,
    569 <command>rmail</command>,
    570 <command>sendmail</command>,
    571 <command>sharedindexinstall</command>,
    572 <command>sharedindexsplit</command>,
    573 <command>showconfig</command>,
    574 <command>showmodules</command>,
    575 <command>testmxlookup</command>,
    576 <command>userdb</command>,
    577 <command>userdbpw</command>,
    578 <command>vchkpw2userdb</command> and
    579 <command>webgpg</command>.</para>
     507<segmentedlist>
     508<segtitle>Installed Programs</segtitle>
     509<segtitle>Installed Scripts</segtitle>
     510<segtitle>Installed Directories</segtitle>
     511<segtitle>Configuration Files</segtitle>
     512<seglistitem>
     513<seg>addcr, aliascreate, aliascombine, aliasexp, authenumerate, cancelmsg,
     514courier, courier-config, courierd, courierfax, courierfilter,
     515courierldapaliasd, courierlogger, couriermlm, courierpop3d, courierpop3login,
     516couriertcpd, couriertls, deliverquota, dotforward, dupfilter, imapd,
     517imaplogin, lockmail, mailbot, maildiracl, maildirkw, maildirmake, maildrop,
     518mailq, makedat, makedatprog, makemime, mimegpg, pcpd, perlfilter, preline,
     519reformail, reformime, rmail, sendmail, showmodules, sqwebmaild, submit,
     520submitmkdir, testmxlookup, userdbpw, webadmin and webmail</seg>
     521
     522<seg>admin-*.pl, application-pdf.filter, application-postscript.filter,
     523authsystem.passwd, cleancache.pl, courierctl.start, couriermlm,
     524courierwebadmin, coverpage, dumpenv.pl, esmtpd, esmtpd-ssl, faxmail,
     525filterctl, htmldoc, image-gif.filter, image-jpeg.filter, image-png.filter,
     526imapd, imapd-ssl, init, ldapsearch, makeacceptmailfor, makealiases, makedat,
     527makehosteddomains, makepercentrelay, makesmtpaccess, makeuserdb,
     528makeuucpneighbors, mkesmtpdcert, mkimapdcert, mkpop3dcert, new_fax,
     529perlfilter-example.pl, perlfilter-wrapper.pl, pop3d, pop3d-ssl, pw2userdb,
     530rootcerts, sendit.sh, sharedindexsplit, sharedindexinstall, sqwebmail,
     531text-plain.filter, userdb, vchkpw2userdb, webadmin.pl, webgpg and
     532webmaild</seg>
     533
     534<seg>/etc/courier, /usr/lib/courier, /usr/share/courier and
     535/var/lib/courier</seg>
     536
     537<seg>/etc/courier/</seg>
     538
     539</seglistitem>
     540</segmentedlist>
     541
     542<variablelist>
     543<bridgehead renderas="sect3">Short Descriptions</bridgehead>
     544<?dbfo list-presentation="list"?>
     545
     546<varlistentry id="cancelmsg">
     547<term><command>cancelmsg</command></term>
     548<listitem><para>removes a message from the mail queue.</para>
     549<indexterm zone="courier-package cancelmsg">
     550<primary sortas="b-cancelmsg">cancelmsg</primary></indexterm>
     551</listitem>
     552</varlistentry>
     553
     554<varlistentry id="courier">
     555<term><command>courier</command></term>
     556<listitem><para>administrative command used to control the courier
     557scheduling engine.</para>
     558<indexterm zone="courier-package courier">
     559<primary sortas="b-courier">courier</primary></indexterm>
     560</listitem>
     561</varlistentry>
     562
     563<varlistentry id="courierfax">
     564<term><command>courierfax</command></term>
     565<listitem><para>sends email messages by fax.</para>
     566<indexterm zone="courier-package courierfax">
     567<primary sortas="b-courierfax">courierfax</primary></indexterm>
     568</listitem>
     569</varlistentry>
     570
     571<varlistentry id="courierfilter">
     572<term><command>courierfilter</command></term>
     573<listitem><para>starts and stops all mail filters installed by
     574<command>filterctl</command>.</para>
     575<indexterm zone="courier-package courierfilter">
     576<primary sortas="b-courierfilter">courierfilter</primary></indexterm>
     577</listitem>
     578</varlistentry>
     579
     580<varlistentry id="courierldapaliasd">
     581<term><command>courierldapaliasd</command></term>
     582<listitem><para>supports mail address aliasing using an LDAP directory.</para>
     583<indexterm zone="courier-package courierldapaliasd">
     584<primary sortas="b-courierldapaliasd">courierldapaliasd</primary></indexterm>
     585</listitem>
     586</varlistentry>
     587
     588<varlistentry id="courierlogger">
     589<term><command>courierlogger</command></term>
     590<listitem><para>captures error messages from other
     591<application>courier</application> applications and forwards them to
     592the system logger.</para>
     593<indexterm zone="courier-package courierlogger">
     594<primary sortas="b-courierlogger">courierlogger</primary></indexterm>
     595</listitem>
     596</varlistentry>
     597
     598<varlistentry id="couriermlm">
     599<term><command>couriermlm</command></term>
     600<listitem><para>sets up, maintains, and manages mailing lists.</para>
     601<indexterm zone="courier-package couriermlm">
     602<primary sortas="b-couriermlm">couriermlm</primary></indexterm>
     603</listitem>
     604</varlistentry>
     605
     606<varlistentry id="courierperlfilter">
     607<term><command>courierperlfilter</command></term>
     608<listitem><para>a sample filter written in perl.</para>
     609<indexterm zone="courier-package courierperlfilter">
     610<primary sortas="b-courierperlfilter">courierperlfilter</primary></indexterm>
     611</listitem>
     612</varlistentry>
     613
     614<varlistentry id="courierpop3d">
     615<term><command>courierpop3d</command></term>
     616<listitem><para>courier pop3 server.</para>
     617<indexterm zone="courier-package courierpop3d">
     618<primary sortas="b-courierpop3d">courierpop3d</primary></indexterm>
     619</listitem>
     620</varlistentry>
     621
     622<varlistentry id="courierpop3login">
     623<term><command>courierpop3login</command></term>
     624<listitem><para>reads the POP3 userid and password and passes them to the
     625authentication modules.</para>
     626<indexterm zone="courier-package courierpop3login">
     627<primary sortas="b-courierpop3login">courierpop3login</primary></indexterm>
     628</listitem>
     629</varlistentry>
     630
     631<varlistentry id="couriertcpd">
     632<term><command>couriertcpd</command></term>
     633<listitem><para>accepts incoming network connections, and runs other
     634courier programs after establishing each network connection.</para>
     635<indexterm zone="courier-package couriertcpd">
     636<primary sortas="b-couriertcpd">couriertcpd</primary></indexterm>
     637</listitem>
     638</varlistentry>
     639
     640<varlistentry id="couriertls">
     641<term><command>couriertls</command></term>
     642<listitem><para>used by applications to encrypt a network connection
     643using SSL/TLS</para>
     644<indexterm zone="courier-package couriertls">
     645<primary sortas="b-couriertls">couriertls</primary></indexterm>
     646</listitem>
     647</varlistentry>
     648
     649<varlistentry id="dotforward">
     650<term><command>dotforward</command></term>
     651<listitem><para>a compatibility module that reads forwarding
     652instructions in $HOME/.forward.</para>
     653<indexterm zone="courier-package dotforward">
     654<primary sortas="b-dotforward">dotforward</primary></indexterm>
     655</listitem>
     656</varlistentry>
     657
     658<varlistentry id="dupfilter">
     659<term><command>dupfilter</command></term>
     660<listitem><para>a threaded filter that tries to block junk E-mail by
     661attempting to detect multiple copies of the same message, which are
     662rejected.</para>
     663<indexterm zone="courier-package dupfilter">
     664<primary sortas="b-dupfilter">dupfilter</primary></indexterm>
     665</listitem>
     666</varlistentry>
     667
     668<varlistentry id="esmtpd">
     669<term><command>esmtpd</command></term>
     670<listitem><para>a control script for courieresmtpd.</para>
     671<indexterm zone="courier-package esmtpd">
     672<primary sortas="b-esmtpd">esmtpd</primary></indexterm>
     673</listitem>
     674</varlistentry>
     675
     676<varlistentry id="esmtpd-msa">
     677<term><command>esmtpd-msa</command></term>
     678<listitem><para>a control script for courieresmtpd, but adds message
     679submission port 587 for the <acronym>MSA</acronym> protocol.</para>
     680<indexterm zone="courier-package esmtpd-msa">
     681<primary sortas="b-esmtpd-msa">esmtpd-msa</primary></indexterm>
     682</listitem>
     683</varlistentry>
     684
     685<varlistentry id="filterctl">
     686<term><command>filterctl</command></term>
     687<listitem><para>installs or uninstalls global mail filters.</para>
     688<indexterm zone="courier-package filterctl">
     689<primary sortas="b-filterctl">filterctl</primary></indexterm>
     690</listitem>
     691</varlistentry>
     692
     693<varlistentry id="imapd">
     694<term><command>imapd</command></term>
     695<listitem><para>the Courier-IMAP server.</para>
     696<indexterm zone="courier-package imapd">
     697<primary sortas="b-imapd">imapd</primary></indexterm>
     698</listitem>
     699</varlistentry>
     700
     701<varlistentry id="lockmail">
     702<term><command>lockmail</command></term>
     703<listitem><para>a helper utility for locking  mailbox files.</para>
     704<indexterm zone="courier-package lockmail">
     705<primary sortas="b-lockmail">lockmail</primary></indexterm>
     706</listitem>
     707</varlistentry>
     708
     709<varlistentry id="mailbot">
     710<term><command>mailbot</command></term>
     711<listitem><para>a <acronym>MIME</acronym>-aware autoresponder utility.</para>
     712<indexterm zone="courier-package mailbot">
     713<primary sortas="b-mailbot">mailbot</primary></indexterm>
     714</listitem>
     715</varlistentry>
     716
     717<varlistentry id="maildiracl">
     718<term><command>maildiracl</command></term>
     719<listitem><para>manages access control lists.</para>
     720<indexterm zone="courier-package maildiracl">
     721<primary sortas="b-maildiracl">maildiracl</primary></indexterm>
     722</listitem>
     723</varlistentry>
     724
     725<varlistentry id="maildirkw">
     726<term><command>maildirkw</command></term>
     727<listitem><para>modifies Courier-IMAP compatible maildir message
     728keywords.</para>
     729<indexterm zone="courier-package maildirkw">
     730<primary sortas="b-maildirkw">maildirkw</primary></indexterm>
     731</listitem>
     732</varlistentry>
     733
     734<varlistentry id="maildirmake">
     735<term><command>maildirmake</command></term>
     736<listitem><para>creates maildirs, and maildir folders.</para>
     737<indexterm zone="courier-package maildirmake">
     738<primary sortas="b-maildirmake">maildirmake</primary></indexterm>
     739</listitem>
     740</varlistentry>
     741
     742<varlistentry id="maildrop">
     743<term><command>maildrop</command></term>
     744<listitem><para>a replacement local mail delivery agent that includes a
     745mail filtering language.</para>
     746<indexterm zone="courier-package maildrop">
     747<primary sortas="b-maildrop">maildrop</primary></indexterm>
     748</listitem>
     749</varlistentry>
     750
     751<varlistentry id="mailq-courier">
     752<term><command>mailq</command></term>
     753<listitem><para>displays a list of all messages that have not been
     754delivered yet.</para>
     755<indexterm zone="courier-package mailq-courier">
     756<primary sortas="b-mailq">mailq</primary></indexterm>
     757</listitem>
     758</varlistentry>
     759
     760<varlistentry id="makeacceptmailfor">
     761<term><command>makeacceptmailfor</command></term>
     762<listitem><para>builds a list of domains to accept mail for, from the
     763<filename class="directory">/etc/courier/esmtpacceptmailfor.dir</filename>
     764directory.</para>
     765<indexterm zone="courier-package makeacceptmailfor">
     766<primary sortas="b-makeacceptmailfor">makeacceptmailfor</primary></indexterm>
     767</listitem>
     768</varlistentry>
     769
     770<varlistentry id="makealiases">
     771<term><command>makealiases</command></term>
     772<listitem><para>builds an alias database from one or more plain text
     773source files.</para>
     774<indexterm zone="courier-package makealiases">
     775<primary sortas="b-makealiases">makealiases</primary></indexterm>
     776</listitem>
     777</varlistentry>
     778
     779<varlistentry id="makedat">
     780<term><command>makedat</command></term>
     781<listitem><para>a utility to create GDBM or DB files from plain text
     782files.</para>
     783<indexterm zone="courier-package makedat">
     784<primary sortas="b-makedat">makedat</primary></indexterm>
     785</listitem>
     786</varlistentry>
     787
     788<varlistentry id="makehosteddomains">
     789<term><command>makehosteddomains</command></term>
     790<listitem><para>rebuilds the contents of the hosteddomains database from the
     791contents of <filename>/tools/etc/courier/hosteddomains</filename>.</para>
     792<indexterm zone="courier-package makehosteddomains">
     793<primary sortas="b-makehosteddomains">makehosteddomains</primary></indexterm>
     794</listitem>
     795</varlistentry>
     796
     797<varlistentry id="makemime">
     798<term><command>makemime</command></term>
     799<listitem><para>creates <acronym>MIME</acronym>-formatted messages from one
     800or more files.</para>
     801<indexterm zone="courier-package makemime">
     802<primary sortas="b-makemime">makemime</primary></indexterm>
     803</listitem>
     804</varlistentry>
     805
     806<varlistentry id="makepercentrelay">
     807<term><command>makepercentrelay</command></term>
     808<listitem><para>builds a list of %-relayed domains from the
     809<filename class="directory">percentrelay.dir</filename> directory.</para>
     810<indexterm zone="courier-package makepercentrelay">
     811<primary sortas="b-makepercentrelay">makepercentrelay</primary></indexterm>
     812</listitem>
     813</varlistentry>
     814
     815<varlistentry id="makesmtpaccess">
     816<term><command>makesmtpaccess</command></term>
     817<listitem><para>builds <acronym>ESMTP</acronym> server access file from the
     818<filename class="directory">/etc/courier/smtpaccess</filename>
     819directory.</para>
     820<indexterm zone="courier-package makesmtpaccess">
     821<primary sortas="b-makesmtpaccess">makesmtpaccess</primary></indexterm>
     822</listitem>
     823</varlistentry>
     824
     825<varlistentry id="makesmtpaccess-msa">
     826<term><command>makesmtpaccess-msa</command></term>
     827<listitem><para>builds <acronym>ESMTP</acronym> server access file from the
     828<filename class="directory">/etc/courier/smtpaccess</filename> directory.
     829This esmtp list is for the <acronym>MSA</acronym> protocol.</para>
     830<indexterm zone="courier-package makesmtpaccess-msa">
     831<primary sortas="b-makesmtpaccess-msa">makesmtpaccess-msa</primary></indexterm>
     832</listitem>
     833</varlistentry>
     834
     835<varlistentry id="makeuserdb">
     836<term><command>makeuserdb</command></term>
     837<listitem><para>builds user/password db from the contents
     838of <filename class="directory">/tools/etc/courier/userdb</filename>.</para>
     839<indexterm zone="courier-package makeuserdb">
     840<primary sortas="b-makeuserdb">makeuserdb</primary></indexterm>
     841</listitem>
     842</varlistentry>
     843
     844<varlistentry id="mimegpg">
     845<term><command>mimegpg</command></term>
     846<listitem><para>signs, encrypts, or decrypts <acronym>MIME</acronym>-formatted
     847email messages using <application>GnuPG</application>.</para>
     848<indexterm zone="courier-package mimegpg">
     849<primary sortas="b-mimegpg">mimegpg</primary></indexterm>
     850</listitem>
     851</varlistentry>
     852
     853<varlistentry id="mkesmtpdcert">
     854<term><command>mkesmtpdcert</command></term>
     855<listitem><para>creates a secure <acronym>SMTP</acronym> test
     856certificate.</para>
     857<indexterm zone="courier-package mkesmtpdcert">
     858<primary sortas="b-mkesmtpdcert">mkesmtpdcert</primary></indexterm>
     859</listitem>
     860</varlistentry>
     861
     862<varlistentry id="mkimapdcert">
     863<term><command>mkimapdcert</command></term>
     864<listitem><para>creates a secure <acronym>IMAP</acronym> test
     865certificate.</para>
     866<indexterm zone="courier-package mkimapdcert">
     867<primary sortas="b-mkimapdcert">mkimapdcert</primary></indexterm>
     868</listitem>
     869</varlistentry>
     870
     871<varlistentry id="mkpop3dcert">
     872<term><command>mkpop3dcert</command></term>
     873<listitem><para>creates a secure <acronym>POP3</acronym> test
     874certificate.</para>
     875<indexterm zone="courier-package mkpop3dcert">
     876<primary sortas="b-mkpop3dcert">mkpop3dcert</primary></indexterm>
     877</listitem>
     878</varlistentry>
     879
     880<varlistentry id="pop3d">
     881<term><command>pop3d</command></term>
     882<listitem><para>a wrapper script for <command>couriertcpd</command> to
     883start and stop the <acronym>POP3</acronym> service.</para>
     884<indexterm zone="courier-package pop3d">
     885<primary sortas="b-pop3d">pop3d</primary></indexterm>
     886</listitem>
     887</varlistentry>
     888
     889<varlistentry id="pop3d-ssl">
     890<term><command>pop3d-ssl</command></term>
     891<listitem><para>a wrapper script for <command>couriertcpd</command> to
     892start and stop the <acronym>POP3</acronym> over <acronym>SSL</acronym>
     893service.</para>
     894<indexterm zone="courier-package pop3d-ssl">
     895<primary sortas="b-pop3d-ssl">pop3d-ssl</primary></indexterm>
     896</listitem>
     897</varlistentry>
     898
     899<varlistentry id="preline">
     900<term><command>preline</command></term>
     901<listitem><para>prepends legacy mbox headers to mail messages.</para>
     902<indexterm zone="courier-package preline">
     903<primary sortas="b-preline">preline</primary></indexterm>
     904</listitem>
     905</varlistentry>
     906
     907<varlistentry id="reformail">
     908<term><command>reformail</command></term>
     909<listitem><para>reads a message on standard input, reformats it in some
     910way, and writes the message to standard output.</para>
     911<indexterm zone="courier-package reformail">
     912<primary sortas="b-reformail">reformail</primary></indexterm>
     913</listitem>
     914</varlistentry>
     915
     916<varlistentry id="reformime">
     917<term><command>reformime</command></term>
     918<listitem><para>a utility for reformatting MIME messages.</para>
     919<indexterm zone="courier-package reformime">
     920<primary sortas="b-reformime">reformime</primary></indexterm>
     921</listitem>
     922</varlistentry>
     923
     924<varlistentry id="sendmail-courier">
     925<term><command>sendmail</command></term>
     926<listitem><para>reads an email message and delivers the message to it's
     927recipients.</para>
     928<indexterm zone="courier-package sendmail-courier">
     929<primary sortas="b-sendmail">sendmail</primary></indexterm>
     930</listitem>
     931</varlistentry>
     932
     933<varlistentry id="submit">
     934<term><command>submit</command></term>
     935<listitem><para>submits messages to <application>Courier</application>for
     936processing.</para>
     937<indexterm zone="courier-package submit">
     938<primary sortas="b-submit">submit</primary></indexterm>
     939</listitem>
     940</varlistentry>
     941
     942<varlistentry id="testmxlookup">
     943<term><command>testmxlookup</command></term>
     944<listitem><para>lists the names and <acronym>IP</acronym> addresses of mail
     945relays that receive mail for the domain.</para>
     946<indexterm zone="courier-package testmxlookup">
     947<primary sortas="b-testmxlookup">testmxlookup</primary></indexterm>
     948</listitem>
     949</varlistentry>
     950
     951<varlistentry id="userdb">
     952<term><command>userdb</command></term>
     953<listitem><para>a script to individually manipulate entries in
     954<filename>/tools/etc/courier/userdb.</filename></para>
     955<indexterm zone="courier-package userdb">
     956<primary sortas="b-userdb">userdb</primary></indexterm>
     957</listitem>
     958</varlistentry>
     959
     960<varlistentry id="userdbpw">
     961<term><command>userdbpw</command></term>
     962<listitem><para>reads a single line of text on standard input, encrypts
     963it, and prints the encrypted result to standard output.</para>
     964<indexterm zone="courier-package userdbpw">
     965<primary sortas="b-userdbpw">userdbpw</primary></indexterm>
     966</listitem>
     967</varlistentry>
     968</variablelist>
    580969
    581970</sect2>
    582971
    583 <sect2><title>Description</title>
    584 
    585 <sect3><title>cancelmsg</title>
    586 <para><command>cancelmsg</command> removes a message from the mail
    587 queue.</para></sect3>
    588 
    589 <sect3><title>courier</title>
    590 <para><command>courier</command> is a modular multi-protocol E-mail
    591 transport agent. The <command>courier</command> command is an
    592 administrative command, and most of its options are only available to
    593 the superuser.</para></sect3>
    594 
    595 <sect3><title>courierfilter</title>
    596 <para><command>courierfilter</command> command installs or uninstalls
    597 global mail filters. Global mail filters are used to selectively block
    598 unwanted mail.</para></sect3>
    599 
    600 <sect3><title>couriermlm</title>
    601 <para><command>couriermlm</command> is the Courier mailing list
    602 manager.</para></sect3>
    603 
    604 <sect3><title>filterctl</title>
    605 <para><command>filterctl</command> command installs or uninstalls global
    606 mail filters. Global mail filters are used to selectively block unwanted
    607 mail.</para></sect3>
    608 
    609 <sect3><title>lockmail</title>
    610 <para><command>lockmail</command> is a helper utility for working with mailbox
    611 files.</para></sect3>
    612 
    613 <sect3><title>mailbot</title>
    614 <para><command>mailbot</command> reads an E-mail message on standard input and
    615 creates an E-mail message replying to the original message's
    616 sender.</para></sect3>
    617 
    618 <sect3><title>maildirkw</title>
    619 <para><command>maildirkw</command> modifies Courier-IMAP compatible maildir
    620 message keywords.</para></sect3>
    621 
    622 <sect3><title>maildrop</title>
    623 <para><command>maildrop</command> is a replacement local mail delivery agent
    624 that includes a mail filtering language.</para></sect3>
    625 
    626 <sect3><title>makeacceptmailfor</title>
    627 <para><command>makeacceptmailfor</command> Build a list of domains to accept
    628 mail for from the
    629 <filename>/etc/courier/esmtpacceptmailfor.dir</filename>
    630 directory.</para></sect3>
    631 
    632 <sect3><title>makealiases</title>
    633 <para><command>makealiases</command> Build a list of aliases from the
    634 <filename>/etc/courier/aliases</filename>
    635 or <filename>/etc/courier/aliasdir</filename> directories.</para></sect3>
    636 
    637 <sect3><title>makehosteddomains</title>
    638 <para><command>makehostedomains</command> Build a database of hosted domains
    639 from <filename>hosteddomains</filename>.</para></sect3>
    640 
    641 <sect3><title>makepercentrelay</title>
    642 <para><command>makepercentrelay</command> Build a list of %-relayed
    643 domains from the <filename>percentrelay.dir</filename>
    644 directory.</para></sect3>
    645 
    646 <sect3><title>makesmtpaccess</title>
    647 <para><command>makesmtpaccess</command> Build ESMTP server access file
    648 from the <filename>/etc/courier/smtpaccess</filename>
    649 directory.</para></sect3>
    650 
    651 <sect3><title>makesmtpaccess-msa</title>
    652 <para><command>makesmtpaccess-msa</command> Build ESMTP server access
    653 file from the <filename>/etc/courier/smtpaccess</filename>
    654 directory. This esmtp list is for the MSA protocol.</para></sect3>
    655 
    656 <sect3><title>makeuucpneighbors</title>
    657 <para><command>makeuucpneighbors</command> Builds a list of
    658 <acronym>UUCP</acronym> recipients using
    659 <filename>/etc/courier/uucpneighbors</filename>.</para></sect3>
    660 
    661 <sect3><title>reformail</title>
    662 <para><command>reformail</command> program reads a message on standard input,
    663 reformats it in some way, and writes the message to standard
    664 output.</para></sect3>
    665 
    666 <sect3><title>reformime</title>
    667 <para><command>reformime</command> is a utility for reformatting MIME
    668 messages.</para></sect3>
    669 
    670 <sect3><title>sendmail</title>
    671 <para><command>sendmail</command> command reads an E-mail message and delivers
    672 the message to its recipients. This sendmail command is part of the Courier
    673 mail server, although it attempts to emulate the behavior of the original
    674 sendmail MTA.</para></sect3>
    675 
    676 <sect3><title>showconfig</title>
    677 <para><command>showconfig</command> Shows the current Courier
    678 configuration.</para></sect3>
    679 
    680 <sect3><title>showmodules</title>
    681 <para><command>showmodules</command> Shows the current Courier
    682 modules.</para></sect3>
    683 
    684 <sect3><title>testmxlookup</title>
    685 <para><command>testmxlookup</command> lists the names and IP addresses of
    686 mail relays that receive mail for the domain.  This is useful in diagnosing
    687 mail delivery problems.</para></sect3>
    688 
    689 </sect2>
    690 
    691972</sect1>
    692973
Note: See TracChangeset for help on using the changeset viewer.