r3155 - in trunk: BOOK BOOK/introduction/welcome BOOK/server/mail bootscripts/blfs/init.d

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Dec 27 14:47:48 PST 2004


Author: randy
Date: 2004-12-27 15:47:47 -0700 (Mon, 27 Dec 2004)
New Revision: 3155

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/server/mail/exim.xml
   trunk/bootscripts/blfs/init.d/exim
Log:
Updated to Exim-4.43; changed Exim bootscript to dispatch a queue runner process every 15 minutes, instead of every minute

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-12-27 06:22:44 UTC (rev 3154)
+++ trunk/BOOK/general.ent	2004-12-27 22:47:47 UTC (rev 3155)
@@ -20,7 +20,7 @@
 <!ENTITY publisher      "Unknown">
 
 
-<!ENTITY blfs-bootscripts-version     "20041203"> 
+<!ENTITY blfs-bootscripts-version     "20041227"> 
 <!ENTITY blfs-bootscripts-download    "&downloads-root;/blfs-bootscripts-&blfs-bootscripts-version;.tar.bz2">
                                      
 <!-- Part II -->                     
@@ -216,7 +216,7 @@
 <!-- Chapter 21 -->                  
 <!ENTITY postfix-version              "2.1.5">
 <!ENTITY sendmail-version             "8.13.1">
-<!ENTITY exim-version                 "4.24">
+<!ENTITY exim-version                 "4.43">
 <!ENTITY qpopper-version              "4.0.5">
 <!ENTITY courier-version              "0.45.5">
                                      

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-12-27 06:22:44 UTC (rev 3154)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-12-27 22:47:47 UTC (rev 3155)
@@ -22,6 +22,10 @@
 
 <itemizedlist>
 
+<listitem><para>December 27th, 2004 [randy]: Updated to Exim-4.43; modified 
+Exim bootscript to dispatch a queue runner every 15 minutes, instead of 
+every minute.</para></listitem>
+
 <listitem><para>December 26th, 2004 [dj]: Updated to OpenOffice 1.1.4
 and added iprout2 patch for rp-pppoe.</para></listitem>
 

Modified: trunk/BOOK/server/mail/exim.xml
===================================================================
--- trunk/BOOK/server/mail/exim.xml	2004-12-27 06:22:44 UTC (rev 3154)
+++ trunk/BOOK/server/mail/exim.xml	2004-12-27 22:47:47 UTC (rev 3155)
@@ -4,11 +4,11 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-<!ENTITY exim-download-http "http://gd.tuwien.ac.at/infosys/mail/exim/exim4/exim-&exim-version;.tar.bz2">
+<!ENTITY exim-download-http "http://www.exim.org/ftp/exim4/exim-&exim-version;.tar.bz2">
 <!ENTITY exim-download-ftp "ftp://ftp.exim.org/pub/exim/exim4/exim-&exim-version;.tar.bz2">
-<!ENTITY exim-size "1.2 MB">
-<!ENTITY exim-buildsize "11 MB">
-<!ENTITY exim-time "0.27 SBU">
+<!ENTITY exim-size "1.4 MB">
+<!ENTITY exim-buildsize "14.9 MB">
+<!ENTITY exim-time "0.14 SBU">
 ]>
 
 <sect1 id="exim" xreflabel="Exim-&exim-version;">
@@ -42,14 +42,20 @@
 
 <sect3><title><application>Exim</application> dependencies</title>
 <sect4><title>Required</title>
-<para><xref linkend="db"/></para>
+<para><xref linkend="db"/> or 
+<xref linkend="gdbm"/> or 
+<ulink url="http://sourceforge.net/projects/tdb">TDB</ulink></para>
 </sect4>
 
 <sect4><title>Optional</title>
 <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), 
-<xref linkend="openldap"/>,
-<xref linkend="mysql"/>,
-<xref linkend="tcpwrappers"/> and
+<xref linkend="openldap"/>, 
+<xref linkend="openssl"/> or 
+<ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>, 
+<xref linkend="cyrus-sasl"/>, 
+<xref linkend="mysql"/>, 
+<xref linkend="postgresql"/>, 
+<xref linkend="tcpwrappers"/> and 
 <xref linkend="Linux_PAM"/></para>
 </sect4>
 </sect3>
@@ -60,7 +66,8 @@
 <title>Installation of <application>Exim</application></title>
 
 <para>Before building <application>Exim</application>, you should 
-create the group and user exim which will run the exim daemon:</para>
+create the group and user exim which will run the 
+<command>exim</command> daemon:</para>
 
 <screen><userinput><command>groupadd exim &&
 useradd -d /dev/null -c "Exim Daemon" -g exim -s /bin/false exim</command></userinput></screen>
@@ -74,33 +81,102 @@
   sed -e 's,^EXIM_MONITOR,#EXIM_MONITOR,' > Local/Makefile &&
 make &&
 make install &&
-cp doc/exim.8 /usr/share/man/man8 &&
-ln -s exim-4.24-1 /usr/sbin/exim &&
-ln -s exim /usr/sbin/sendmail</command></userinput></screen>
+install -v -m644 doc/exim.8 /usr/share/man/man8 &&
+install -v -d -m755 /usr/share/doc/exim-&exim-version; &&
+install -v -m644 doc/* /usr/share/doc/exim-&exim-version; &&
+ln -sv exim /usr/sbin/sendmail</command></userinput></screen>
 
 </sect2>
 
 <sect2>
 <title>Command explanations</title>
 
-<para><command>sed -e ... > Local/Makefile</command>: Many of 
-<application>Exim</application>'s configuration options are compiled in. 
-This command specifies the minimum set of options, 
-<parameter>BIN_DIRECTORY</parameter>, <parameter>CONFIGURE_FILE</parameter> 
-and <parameter>EXIM_USER</parameter>. Additionally, building the 
-<application>Exim</application> monitor program is deferred, as it 
-requires <application>X</application> Window System support, by commenting 
-out the <parameter>EXIM_MONITOR</parameter> line in the 
-<filename>Makefile</filename>.</para>
+<para><command>sed -e ... > Local/Makefile</command>: Most of 
+<application>Exim</application>'s configuration options are compiled in using 
+the directives in <filename>Local/Makefile</filename> which is created from 
+the <filename>src/EDITME</filename> file. This command specifies the minimum 
+set of options. Descriptions for the options are listed below.</para>
 
-<para><command>ln -s exim /usr/sbin/sendmail</command>:
-Creates a link to <command>sendmail</command> for applications which need 
-it. <application>Exim</application> will
-accept most <application>Sendmail</application> command-line options.</para>
+<para><parameter>BIN_DIRECTORY=/usr/sbin</parameter>: This installs all of 
+<application>Exim</application>'s binaries and scripts in 
+<filename class='directory'>/usr/sbin</filename>.</para>
 
+<para><parameter>CONFIGURE_FILE=/etc/exim.conf</parameter>: This installs 
+<application>Exim</application>'s main configuration file in 
+<filename class='directory'>/etc</filename>.</para>
+
+<para><parameter>EXIM_USER=exim</parameter>: This tells 
+<application>Exim</application> that after the daemon no longer needs root 
+privileges, the process hands off the daemon to the exim user.</para>
+
+<para><parameter>#EXIM_MONITOR</parameter>: This defers building the 
+<application>Exim</application> monitor program, as it requires 
+<application>X</application> Window System support, by commenting out the 
+<parameter>EXIM_MONITOR</parameter> line in the <filename>Makefile</filename>. 
+If you wish to build the monitor program, omit this <command>sed</command> 
+command and issue the following command before building the package (modify 
+<filename>Local/eximon.conf</filename>, if necessary): 
+<command>cp exim_monitor/EDITME Local/eximon.conf</command>.</para>
+
+<para><command>ln -s exim /usr/sbin/sendmail</command>: Creates a link to 
+<command>sendmail</command> for applications which need it. 
+<application>Exim</application> will accept most 
+<application>Sendmail</application> command-line options.</para>
+
 </sect2>
 
 <sect2>
+<title>Adding additional functionality</title>
+
+<para>To utilize some or all of the dependency packages, you'll need to modify 
+<filename>Local/Makefile</filename> to include the appropriate directives and 
+parameters to link additional libraries before you build 
+<application>Exim</application>. <filename>Local/Makefile</filename> is 
+heavily commented with instructions on how to do this. Listed below is 
+additional information to help you link these dependency packages.</para>
+
+<para>To use a backend database other than <application>Berkelely 
+DB</application>, see the instructions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.3"/>.</para>
+
+<para>For <acronym>SSL</acronym> functionality, see the instructions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.6"/> and 
+<ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_37.html#CHAP37"/>.</para>
+
+<para>For <application>tcpwrappers</application> functionality, see the 
+instructions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.7"/>.</para>
+
+<para>For information about adding authentication mechanisms to the 
+build, see the instructions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_34.html#SECT34.4"/> For 
+specific information about using <application>Cyrus-SASL</application>, see 
+section 10 of the <filename>doc/NewStuff</filename> file located in the source 
+tree.</para>
+
+<para>For information about linking <application>Linux-PAM</application>, see 
+the instuctions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_11.html#IX935"/>.</para>
+
+<para>For information about linking database engine libraries used for 
+<application>Exim</application> name lookups, see the instuctions at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_9.html#CHAP9"/>.</para> 
+
+<para>If you wish to add <application>Readline</application> support to 
+<application>Exim</application> when invoked in <quote>test expansion</quote> 
+(-bv) mode, see the information in section 8 of the 
+<filename>doc/NewStuff</filename> file located in the source tree.</para>
+
+<para>You may wish to modify the default configuration and send log files to 
+syslog instead of the default 
+<filename class='directory'>/var/spool/exim/log</filename> directory. See the 
+information at <ulink 
+url="http://www.exim.org/exim-html-4.40/doc/html/spec_45.html#CHAP45"/>.</para>
+
+</sect2>
+
+<sect2>
 <title>Configuring Exim</title>
 
 <sect3><title>Config files</title>
@@ -112,25 +188,37 @@
 
 <sect3><title>Configuration Information</title>
 
-<para>Create the Exim configuration files with the following commands:</para>
+<para>A default (nothing but comments) <filename>/etc/aliases</filename> file 
+is installed during the package installation if this file did not exist on 
+your system. Create the necessary aliases and start the 
+<application>Exim</application> daemon using the following commands:</para>
 
 <screen><userinput><command>cat >> /etc/aliases << "EOF"</command>
 postmaster: root
 MAILER-DAEMON: root
 <command>EOF
 exim -v -bi &&
-/usr/sbin/exim -bd -q1m</command></userinput></screen>
+/usr/sbin/exim -bd -q15m</command></userinput></screen>
 
 <note><para>To protect an existing <filename>/etc/aliases</filename> file, 
-append these aliases to it if it exists. This file should be checked and 
+the command above appends these aliases to it. This file should be checked and 
 duplicate aliases removed, if present.</para></note>
 
+<para>The <command>/usr/sbin/exim -bd -q15m</command> command starts the 
+<application>Exim</application> daemon with a 15 minute interval in processing 
+the mail queue. Adjust this parameter to suit your desires.</para>
+
 <para>To automate the running of <command>exim</command> at startup, install 
 the <filename>/etc/rc.d/init.d/exim</filename> init script included in the 
 <xref linkend="intro-important-bootscripts"/> package.</para>
 
 <screen><userinput><command>make install-exim</command></userinput></screen>
 
+<para>The bootscript also starts the <application>Exim</application> daemon 
+and dispatches a queue runner process every 15 minutes. Modify the 
+<parameter>-q<replaceable>[time interval]</replaceable></parameter> parameter 
+in <filename>/etc/rc.d/init.d/exim</filename>, if necessary for your 
+installation.</para>
 </sect3>
 
 </sect2>
@@ -151,8 +239,10 @@
 <command>eximstats</command>,
 <command>exiqsumm</command>,
 <command>exiqgrep</command>,
-<command>exim_lock</command> and
-<command>exim_checkaccess</command>.</para>
+<command>exim_lock</command>, 
+<command>exim_checkaccess</command> and optionally, 
+<command>eximon</command> and 
+<command>eximon.bin</command>.</para>
 
 </sect2>
 

Modified: trunk/bootscripts/blfs/init.d/exim
===================================================================
--- trunk/bootscripts/blfs/init.d/exim	2004-12-27 06:22:44 UTC (rev 3154)
+++ trunk/bootscripts/blfs/init.d/exim	2004-12-27 22:47:47 UTC (rev 3155)
@@ -13,7 +13,7 @@
 case "$1" in
 	start)
 		echo "Starting exim..."
-		loadproc /usr/sbin/exim -bd -q1m
+		loadproc /usr/sbin/exim -bd -q15m
 		;;
 
 	stop)




More information about the blfs-book mailing list