source: server/mail/exim.xml@ bc6e56d

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since bc6e56d was bc6e56d, checked in by Krejzi <krejzi@…>, 12 years ago

Removed TCP Wrappers. Inkscape 0.48.3.1 and VLC 2.0.3.

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