please be familiar with how Exim works. At minimum, have read this
README file and the manpages delivered with the Debian Exim 4
packages, and <filename>/usr/share/doc/exim4-base/spec.txt.gz</filename>
- chapters 3 and 6. <filename>spec.txt.gz</filename> is an excellent
- reference.
+ chapters <phrase>"How Exim receives and delivers mail"</phrase> and
+ <phrase>"The Exim run time configuration file"</phrase>.
+ <filename>spec.txt.gz</filename> is an excellent reference.
</para>
<para>
Please note that while most free-form fields in the
list extra care needs to be taken in this case.
<emphasis>Unresolvable names in the host list will break
relaying.</emphasis> See
- <ulink url="http://www.exim.org/exim-html-current/doc/html/spec_html/ch-domain_host_address_and_local_part_lists.html">
- Exim specification - chapter Domain, host, address, and
- local part lists
- </ulink> and the exim4-config_files man page.
+ Exim specification chapter <phrase>"Domain, host, address, and
+ local part lists"</phrase>
+ and the exim4-config_files man page.
</para>
</section>
<section> <title>IP address or host name of the outgoing
<para>
Multiple smarthost entries are permitted, semicolon
separated. Each of the hosts is tried, in the order
- specified (See Exim specification, chapter 20.5).
+ specified (See Exim specification, chapter
+ <phrase>"The manualroute router"</phrase>, section
+ <phrase>"How the list of hosts is used"</phrase>.)
</para>
</section>
<section> <title>Hide local mail name in outgoing mail</title>
setting macros. That way, you can switch on and off certain
parts of the default configuration and/or override values set
in Debconf without having to touch the dpkg-conffiles. While
- touching dpkg-conffiles itself is explitly allowed and wanted,
+ touching dpkg-conffiles itself is explicitly allowed and wanted,
it can be quite a nuisance to be asked on package upgrade
whether one wants to use the locally changed file or the
file changed by the package maintainer.
<para>
into the appropriate file. For more detailed discussion of the
general macro mechanism, see the Exim specification, chapter
- 6.4, for details how macro expansion works.
+ <phrase>"The Exim run time configuration file"</phrase>, for
+ details how macro expansion works.
</para>
</section>
<section> <title>How does this work?</title>
(most prominent example being nearly all versions of Microsoft
Outlook and Outlook Express, and Incredimail) insist on doing
TLS on connect on Port 465. If you need to support these, set
- SMTPLISTENEROPTIONS='-oX 465:25 -oP /var/run/exim4/exim.pid'
+ SMTPLISTENEROPTIONS='-oX 465:25 -oP /run/exim4/exim.pid'
in <filename>/etc/default/exim4</filename> and
"tls_on_connect_ports=465" in the main configuration section.
</para>
job will malfunction.
</para>
<para>
- It might be appropriate to add "+tls_cipher +tls_peerdn" to
+ It might be appropriate to add "+tls_cipher" to
any log_selector statement you might already have, or to add a
log_selector statement setting these two options in a local
- configuration file. These options have Exim log what cipher
+ configuration file. (For Debian's configuration simply define
+ the MAIN_LOG_SELECTOR macro.)
+ This option makes Exim log what cipher
your Exim and the peer's mailer have negotiated to use to
- encrypt the transaction, and they have Exim log the
- Distinguished Name of the peer's certificate.
+ encrypt the transaction.
</para>
<para>
Exim can be configured to ask a client for a certificate and to
to no. <command>E4BCD_WATCH_PANICLOG=once</command> will
rotate a non-empty paniclog automatically after sending out
the warning e-mail.
+ </simpara>
+ <simpara>
+ The <command>E4BCD_PANICLOG_LINES</command> setting can be
+ used to limit the number of lines of paniclog quoted in
+ warning email. It is set to 10 by default.
</simpara>
</listitem>
<listitem>
</para>
<para>
Just in case that you need exceptions to the rule,
- <filename>/etc/exim4/lowuid_aliases</filename> is an alias
+ <filename>/etc/exim4/lowuid-aliases</filename> is an alias
file that is only honored for local accounts with UID lower
than FIRST_USER_ACCOUNT_UID. If you define an alias for such an
account here, incoming mail is processed according to the
alias. If you alias the account to itself, messages are
delivered to the account itself, which is an exception to the
rule that messages for low-UID accounts are rejected. The
- format of <filename>/etc/exim4/lowuid_aliases</filename> is
+ format of <filename>/etc/exim4/lowuid-aliases</filename> is
just another alias file.
</para>
</section>
<section> <title>How to bypass local routing specialities</title>
<para>
- Sometimes, it might be desireable to be able to bypass local
+ Sometimes, it might be desirable to be able to bypass local
routing specialities like the alias file or a user-forward
file. This is possible in the Debian Exim4 packages by
prefixing the account name with "real-". For a local account
<section> <title>Misc Notes</title>
<section> <title>PAM</title>
<para>
- PAM: On Debian systems the PAM modules run as the same user
+ On Debian systems the PAM modules run as the same user
as the calling program, so they cannot do anything you
could not do yourself, and in particular cannot access
<filename>/etc/shadow</filename> unless the user is in group
In the default configuration, Exim cannot locally deliver
mail to accounts which have capitals in their name. This is
caused by the fact that Exim converts the local part of incoming
- mail to lower case before the comparision done by the
+ mail to lower case before the comparison done by the
check_local_user directive in routers is done.
</para>
<para>
</section>
</section>
<section> <title>Debian modifications to the Exim source</title>
- <variablelist>
- <varlistentry>
- <term>
- <ulink url="http://www.arise.demon.co.uk/exim-patches/">
- Patches</ulink> by Steve Haslam:
- </term>
- <listitem>
- <simpara>
- boolean_redefine_protect
- [src/mytypes.h]
- Surround the definition of TRUE and FALSE macros with #ifndef
- /#endif, in case some other header defines them (from mixing No
- Perl and Exim, istr)
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- Other stuff
- </term>
- <listitem>
- <itemizedlist>
- <listitem>
- <simpara>
- link exim dynamically against pcre.
- </simpara>
- </listitem>
- <listitem>
- <para>
- The main binary is /usr/sbin/exim4:
- <itemizedlist>
- <listitem>
- <simpara>
- src/globals.c was changed to use 'US
- BIN_DIRECTORY "/exim4"' as default for
- exim_path.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- changed default for $exim_path (modulo
- lower/upper case) from BIN_DIRECTORY/exim to
- BIN_DIRECTORY/exim4 in exicyclog.src,
- exim_checkaccess.src, eximon.src, exinext.src,
- exiqgrep.src, exiwhat.src.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- OS/Makefile-Linux:EXIWHAT_MULTIKILL_ARG=exim4
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- <listitem>
- <simpara>
- <ulink
-url="http://marc.merlins.org/linux/exim/files/sa-exim-current/">localscan_dlopen
-.patch</ulink>:
- Allow to use and switch between different local_scan
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Install the exim binary as /usr/sbin/exim4 instead of
+ /usr/sbin/exim-<version> with a symlink /usr/sbin/exim. Also
+ adapt the documentation.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Make the build reproducible. Pull date/time from debian/changelog
+ and use it as build time instead of using __DATE__.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Documentation updates
+ </simpara>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ Mention how to install the Debian packaged perl-modules needed
+ for eximstats' graphs.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Add a warning about convert4r4.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Point to the <ulink
+ url="mailto:pkg-exim4-users@lists.alioth.debian.org">
+ Debian-specific mailing list</ulink> instead of
+ the <ulink url="mailto:exim-users@exim.org">official
+ exim-users list</ulink>.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <simpara>
+ <ulink
+ url="http://marc.merlins.org/linux/exim/files/sa-exim-current/">localscan_dlopen.patch</ulink>:
+ This patch makes it possible to use and switch between
+ different local_scan
functions without recompiling Exim. Use
local_scan_path = /path/to/sharedobject to utilize
local_scan() in <filename>/path/to/sharedobject</filename>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- changes to the documentation to have the <ulink
- url="mailto:pkg-exim4-users@lists.alioth.debian.org">
- Debian-specific mailing list</ulink> mentioned where
- the <ulink url="mailto:exim-users@exim.org">official
- exim-users list</ulink> is mentioned
- </simpara>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
+ </simpara>
+ </listitem>
+ </itemizedlist>
</section>
<section> <title>Credits</title>
HCoop / hcoop / debian / exim4.git / blobdiff