source: archive/courier.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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