source: server/mail/exim.xml@ 3d8851e

10.0 10.1 11.0 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3d8851e was 3d8851e, checked in by Igor Živković <igor@…>, 7 years ago

validation fix

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

  • Property mode set to 100644
File size: 20.0 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 <!ENTITY exim-download-http "http://ftp.exim.org/pub/exim/exim4/exim-&exim-version;.tar.bz2">
8 <!ENTITY exim-download-ftp "ftp://ftp.exim.org/pub/exim/exim4/exim-&exim-version;.tar.bz2">
9 <!ENTITY exim-md5sum "fc6790f346a50a3c87be96b335b9c8ae">
10 <!ENTITY exim-size "1.7 MB">
11 <!ENTITY exim-buildsize "17 MB">
12 <!ENTITY exim-time "0.2 SBU">
13
14
15
16 <!ENTITY exim-daemon-version "&exim-version;-3">
17]>
18
19<sect1 id="exim" xreflabel="Exim-&exim-version;">
20 <?dbhtml filename="exim.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Exim-&exim-version;</title>
28
29 <indexterm zone="exim">
30 <primary sortas="a-Exim">Exim</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Exim</title>
35
36 <para>The <application>Exim</application> package contains a Mail
37 Transport Agent written by the University of Cambridge, released
38 under the GNU Public License.</para>
39
40 &lfs75_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>Download (HTTP): <ulink url="&exim-download-http;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download (FTP): <ulink url="&exim-download-ftp;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download MD5 sum: &exim-md5sum;</para>
52 </listitem>
53 <listitem>
54 <para>Download size: &exim-size;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated disk space required: &exim-buildsize;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated build time: &exim-time;</para>
61 </listitem>
62 </itemizedlist>
63
64 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
65 <itemizedlist spacing="compact">
66 <listitem>
67 <para>Additional formats of the documentation (text-based docs are
68 shipped with the sources) can be downloaded by following the links
69 shown at <ulink url="http://exim.org/docs.html"/>.</para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Exim Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="pcre"/>
78 </para>
79
80 <bridgehead renderas="sect4">Optional</bridgehead>
81 <para role="optional">
82 <xref linkend="db"/> or
83 <ulink url="http://sourceforge.net/projects/tdb">TDB</ulink> (as an
84 alternative to GDBM, built in LFS),
85 <xref linkend="x-window-system"/>,
86 <xref linkend="openldap"/>,
87 <xref linkend="openssl"/> or <xref linkend="gnutls"/>,
88 <xref linkend="cyrus-sasl"/>,
89 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
90 <xref linkend="postgresql"/>,
91 <xref linkend="sqlite"/>,
92 <xref linkend="linux-pam"/>, and
93 <ulink url="http://www.trusteddomain.org/opendmarc/">OpenDMARC</ulink>
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/exim"/></para>
98
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of Exim</title>
103
104 <para>Before building <application>Exim</application>, as the
105 <systemitem class="username">root</systemitem> user you should create
106 the group and user <systemitem class="username">exim</systemitem> which
107 will run the <command>exim</command> daemon:</para>
108
109<screen role="root"><userinput>groupadd -g 31 exim &amp;&amp;
110useradd -d /dev/null -c "Exim Daemon" -g exim -s /bin/false -u 31 exim</userinput></screen>
111
112 <para>Install <application>Exim</application> with the following
113 commands:</para>
114
115<screen><userinput>sed -e 's,^BIN_DIR.*$,BIN_DIRECTORY=/usr/sbin,' \
116 -e 's,^CONF.*$,CONFIGURE_FILE=/etc/exim.conf,' \
117 -e 's,^EXIM_USER.*$,EXIM_USER=exim,' \
118 -e 's,^EXIM_MONITOR,#EXIM_MONITOR,' src/EDITME > Local/Makefile &amp;&amp;
119echo -e "USE_GDBM = yes\nDBMLIB = -lgdbm" >> Local/Makefile &amp;&amp;
120make</userinput></screen>
121
122 <para>This package does not come with a test suite.</para>
123
124 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
125
126<!-- dev note: make INSTALL_ARG=-no_chown DESTDIR=<DESTDIR> install -->
127
128<screen role="root"><userinput>make install &amp;&amp;
129install -v -m644 doc/exim.8 /usr/share/man/man8 &amp;&amp;
130install -v -d -m755 /usr/share/doc/exim-&exim-version; &amp;&amp;
131install -v -m644 doc/* /usr/share/doc/exim-&exim-version; &amp;&amp;
132ln -sfv exim /usr/sbin/sendmail</userinput></screen>
133
134 </sect2>
135
136 <sect2 role="commands">
137 <title>Command Explanations</title>
138
139 <para><command>sed -e ... > Local/Makefile</command>: Most of
140 <application>Exim</application>'s configuration options are compiled in using
141 the directives in <filename>Local/Makefile</filename> which is created from
142 the <filename>src/EDITME</filename> file. This command specifies the minimum
143 set of options. Descriptions for the options are listed below.</para>
144
145 <para><command>echo -e ... > Local/Makefile</command>: Setting those
146 variables allows to use GDBM instead of the default Berkeley DB. Remove
147 this command if you have installed <xref linkend="db"/>.</para>
148
149 <para><parameter>BIN_DIRECTORY=/usr/sbin</parameter>: This installs all of
150 <application>Exim</application>'s binaries and scripts in
151 <filename class='directory'>/usr/sbin</filename>.</para>
152
153 <para><parameter>CONFIGURE_FILE=/etc/exim.conf</parameter>: This installs
154 <application>Exim</application>'s main configuration file in
155 <filename class='directory'>/etc</filename>.</para>
156
157 <para><parameter>EXIM_USER=exim</parameter>: This tells
158 <application>Exim</application> that after the daemon no longer needs
159 <systemitem class="username">root</systemitem> privileges, the process
160 hands off the daemon to the <systemitem
161 class="username">exim</systemitem> user.</para>
162
163 <para><parameter>#EXIM_MONITOR</parameter>: This defers building the
164 <application>Exim</application> monitor program, as it requires
165 <application>X Window System</application> support, by commenting out the
166 <parameter>EXIM_MONITOR</parameter> line in the <filename>Makefile</filename>.
167 If you wish to build the monitor program, omit this <command>sed</command>
168 command and issue the following command before building the package (modify
169 <filename>Local/eximon.conf</filename>, if necessary):
170 <command>cp exim_monitor/EDITME Local/eximon.conf</command>.</para>
171
172 <para><command>ln -sfv exim /usr/sbin/sendmail</command>: Creates a link to
173 <command>sendmail</command> for applications which need it.
174 <application>Exim</application> will accept most
175 <application>Sendmail</application> command-line options.</para>
176
177 </sect2>
178
179 <sect2 role="commands">
180 <title>Adding Additional Functionality</title>
181
182 <para>To utilize some or all of the dependency packages, you'll need to
183 modify <filename>Local/Makefile</filename> to include the appropriate
184 directives and parameters to link additional libraries before you build
185 <application>Exim</application>. <filename>Local/Makefile</filename> is
186 heavily commented with instructions on how to do this. Listed below is
187 additional information to help you link these dependency packages or
188 add additional functionality.</para>
189
190 <para>If you wish to build and install the
191 <filename class='extension'>.info</filename> documentation, refer to <ulink
192 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinsinfdoc"/>.</para>
193
194 <para>If you wish to build in Exim's interfaces for calling virus and spam
195 scanning software directly from access control lists, uncomment the
196 <option>WITH_CONTENT_SCAN=yes</option> parameter and review the information
197 found at <ulink
198 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch41.html"/>.</para>
199
200 <para>To use a backend database other than <application>Berkeley
201 DB</application>, see the instructions at <ulink
202 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTdb"/>.</para>
203
204 <para>For SSL functionality, see the instructions at <ulink
205 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinctlsssl"/>
206 and <ulink
207 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch39.html"/>.</para>
208
209 <para>For <application>tcpwrappers</application> functionality, see the
210 instructions at <ulink
211 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECID27"/>.</para>
212
213 <para>For information about adding authentication mechanisms to the
214 build, see chapters 33-37 of <ulink
215 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/index.html"/>.</para>
216
217 <para>For information about linking <application>Linux-PAM</application>,
218 refer to the instructions <ulink
219 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch11.html#SECTexpcond"/>.</para>
220
221 <para>For information about linking database engine libraries used for
222 <application>Exim</application> name lookups, see the instructions at <ulink
223 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch09.html"/>.</para>
224
225 <para>If you wish to add <application>Readline</application> support to
226 <application>Exim</application> when invoked in <quote>test expansion</quote>
227 (<option>-be</option>) mode, see the information in the <option>-be</option>
228 section of <ulink
229 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch05.html#id2525974"/>.</para>
230
231 <para>You may wish to modify the default configuration and send log files to
232 syslog instead of the default
233 <filename class='directory'>/var/spool/exim/log</filename> directory. See the
234 information at <ulink
235 url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch49.html"/>.</para>
236
237 </sect2>
238
239 <sect2 role="configuration">
240 <title>Configuring Exim</title>
241
242 <sect3 id="exim-config">
243 <title>Config Files</title>
244
245 <para><filename>/etc/exim.conf</filename> and
246 <filename>/etc/aliases</filename></para>
247
248 <indexterm zone="exim exim-config">
249 <primary sortas="e-etc-exim.conf">/etc/exim.conf</primary>
250 </indexterm>
251
252 <indexterm zone="exim exim-config">
253 <primary sortas="e-etc-aliases">/etc/aliases</primary>
254 </indexterm>
255
256 </sect3>
257
258 <sect3>
259 <title>Configuration Information</title>
260
261 <para>A default (nothing but comments) <filename>/etc/aliases</filename>
262 file is installed during the package installation if this file did not
263 exist on your system. Create the necessary aliases and start the
264 <application>Exim</application> daemon using the following commands:</para>
265
266<screen role="root"><userinput>cat &gt;&gt; /etc/aliases &lt;&lt; "EOF"
267<literal>postmaster: root
268MAILER-DAEMON: root</literal>
269EOF
270exim -v -bi &amp;&amp;
271/usr/sbin/exim -bd -q15m</userinput></screen>
272
273 <note>
274 <para>To protect an existing <filename>/etc/aliases</filename> file,
275 the command above appends these aliases to it. This file should be
276 checked and duplicate aliases removed, if present.</para>
277 </note>
278
279 <para>The <command>/usr/sbin/exim -bd -q15m</command> command starts
280 the <application>Exim</application> daemon with a 15 minute interval
281 in processing the mail queue. Adjust this parameter to suit your
282 desires.</para>
283
284 </sect3>
285
286 <sect3 id="exim-init">
287 <title>Boot Script</title>
288
289 <para>To automate the running of <command>exim</command> at startup,
290 install the <filename>/etc/rc.d/init.d/exim</filename> init script
291 included in the <xref linkend="bootscripts"/>
292 package.</para>
293
294 <indexterm zone="exim exim-init">
295 <primary sortas="f-exim">exim</primary>
296 </indexterm>
297
298<screen role="root"><userinput>make install-exim</userinput></screen>
299
300 <para>The bootscript also starts the <application>Exim</application>
301 daemon and dispatches a queue runner process every 15 minutes. Modify
302 the <option>-q<replaceable>&lt;time interval&gt;</replaceable></option>
303 parameter in <filename>/etc/rc.d/init.d/exim</filename>, if necessary
304 for your installation.</para>
305
306 </sect3>
307
308 </sect2>
309
310 <sect2 role="content">
311 <title>Contents</title>
312
313 <segmentedlist>
314 <segtitle>Installed Programs</segtitle>
315 <segtitle>Installed Libraries</segtitle>
316 <segtitle>Installed Directories</segtitle>
317
318 <seglistitem>
319 <seg>exicyclog, exigrep, exim, exim-&exim-daemon-version;, exim_checkaccess,
320 exim_dbmbuild, exim_dumpdb, exim_fixdb, exim_lock, exim_tidydb,
321 eximstats, exinext, exipick, exiqgrep, exiqsumm, exiwhat, and
322 optionally, eximon, eximon.bin, and sendmail (symlink)</seg>
323 <seg>None</seg>
324 <seg>/usr/share/doc/exim-&exim-version; and /var/spool/exim</seg>
325 </seglistitem>
326 </segmentedlist>
327
328 <variablelist>
329 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
330 <?dbfo list-presentation="list"?>
331 <?dbhtml list-presentation="table"?>
332
333 <varlistentry id="exicyclog">
334 <term><command>exicyclog</command></term>
335 <listitem>
336 <para>cycles <application>Exim</application> log files.</para>
337 <indexterm zone="exim exicyclog">
338 <primary sortas="b-exicyclog">exicyclog</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="exigrep">
344 <term><command>exigrep</command></term>
345 <listitem>
346 <para>searches <application>Exim</application> log files.</para>
347 <indexterm zone="exim exigrep">
348 <primary sortas="b-exigrep">exigrep</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="exim-prog">
354 <term><command>exim</command></term>
355 <listitem>
356 <para>is a symlink to the <command>exim-&exim-daemon-version;</command>
357 MTA daemon.</para>
358 <indexterm zone="exim exim-prog">
359 <primary sortas="b-exim">exim</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="exim-current_version">
365 <term><command>exim-&exim-daemon-version;</command></term>
366 <listitem>
367 <para>is the <application>Exim</application> mail transport
368 agent daemon.</para>
369 <indexterm zone="exim exim-current_version">
370 <primary sortas="b-exim-&exim-daemon-version;">exim-&exim-daemon-version;</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 <varlistentry id="exim_checkaccess">
376 <term><command>exim_checkaccess</command></term>
377 <listitem>
378 <para>states whether a given recipient address from a given host is
379 acceptable or not.</para>
380 <indexterm zone="exim exim_checkaccess">
381 <primary sortas="b-exim_checkaccess">exim_checkaccess</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="exim_dbmbuild">
387 <term><command>exim_dbmbuild</command></term>
388 <listitem>
389 <para> creates and rebuilds <application>Exim</application>
390 databases.</para>
391 <indexterm zone="exim exim_dbmbuild">
392 <primary sortas="b-exim_dbmbuild">exim_dbmbuild</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="exim_dumpdb">
398 <term><command>exim_dumpdb</command></term>
399 <listitem>
400 <para> writes the contents of <application>Exim</application>
401 databases to the standard output.</para>
402 <indexterm zone="exim exim_dumpdb">
403 <primary sortas="b-exim_dumpdb">exim_dumpdb</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="exim_fixdb">
409 <term><command>exim_fixdb</command></term>
410 <listitem>
411 <para>modifies data in <application>Exim</application>
412 databases.</para>
413 <indexterm zone="exim exim_fixdb">
414 <primary sortas="b-exim_fixdb">exim_fixdb</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="exim_lock">
420 <term><command>exim_lock</command></term>
421 <listitem>
422 <para>locks a mailbox file.</para>
423 <indexterm zone="exim exim_lock">
424 <primary sortas="b-exim_lock">exim_lock</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="exim_tidydb">
430 <term><command>exim_tidydb</command></term>
431 <listitem>
432 <para>removes old records from <application>Exim</application>
433 databases.</para>
434 <indexterm zone="exim exim_tidydb">
435 <primary sortas="b-exim_tidydb">exim_tidydb</primary>
436 </indexterm>
437 </listitem>
438 </varlistentry>
439
440 <varlistentry id="eximstats">
441 <term><command>eximstats</command></term>
442 <listitem>
443 <para>generates mail statistics from <application>Exim</application>
444 log files.</para>
445 <indexterm zone="exim eximstats">
446 <primary sortas="b-eximstats">eximstats</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="exinext">
452 <term><command>exinext</command></term>
453 <listitem>
454 <para>queries remote host retry times.</para>
455 <indexterm zone="exim exinext">
456 <primary sortas="b-exinext">exinext</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>
460
461 <varlistentry id="exipick">
462 <term><command>exipick</command></term>
463 <listitem>
464 <para>selects messages based on various criteria.</para>
465 <indexterm zone="exim exipick">
466 <primary sortas="b-exipick">exipick</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="exiqgrep">
472 <term><command>exiqgrep</command></term>
473 <listitem>
474 <para>is a utility for selective queue listing.</para>
475 <indexterm zone="exim exiqgrep">
476 <primary sortas="b-exiqgrep">exiqgrep</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="exiqsumm">
482 <term><command>exiqsumm</command></term>
483 <listitem>
484 <para>produces a summary of the messages in the mail queue.</para>
485 <indexterm zone="exim exiqsumm">
486 <primary sortas="b-exiqsumm">exiqsumm</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="exiwhat">
492 <term><command>exiwhat</command></term>
493 <listitem>
494 <para>queries running <application>Exim</application>
495 processes.</para>
496 <indexterm zone="exim exiwhat">
497 <primary sortas="b-exiwhat">exiwhat</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 <varlistentry id="eximon">
503 <term><command>eximon</command></term>
504 <listitem>
505 <para>is a start-up shell script for <command>eximon.bin</command>
506 used to set the required environment variables before running the
507 program.</para>
508 <indexterm zone="exim eximon">
509 <primary sortas="b-eximon">eximon</primary>
510 </indexterm>
511 </listitem>
512 </varlistentry>
513
514 <varlistentry id="eximon.bin">
515 <term><command>eximon.bin</command></term>
516 <listitem>
517 <para>is a monitor program which displays current information in an
518 <application>X</application> window, and also contains a menu interface
519 to <application>Exim</application>'s command line administration
520 options.</para>
521 <indexterm zone="exim eximon.bin">
522 <primary sortas="b-eximon.bin">eximon.bin</primary>
523 </indexterm>
524 </listitem>
525 </varlistentry>
526
527 </variablelist>
528
529 </sect2>
530
531</sect1>
Note: See TracBrowser for help on using the repository browser.