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

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

Removed the Berkeley DB dependency from packages utilizing it as BDB is now built in LFS

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