source: archive/courier.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

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