summaryrefslogtreecommitdiffstats
path: root/debian/manpages
diff options
context:
space:
mode:
Diffstat (limited to 'debian/manpages')
-rw-r--r--debian/manpages/exicyclog.875
-rw-r--r--debian/manpages/exigrep.870
-rw-r--r--debian/manpages/exim4-config_files.5364
-rw-r--r--debian/manpages/exim_checkaccess.880
-rw-r--r--debian/manpages/exim_convert4r4.873
-rw-r--r--debian/manpages/exim_db.8193
-rw-r--r--debian/manpages/exim_dbmbuild.8105
-rw-r--r--debian/manpages/exim_lock.8137
-rw-r--r--debian/manpages/eximon.850
-rw-r--r--debian/manpages/exinext.873
-rw-r--r--debian/manpages/exiqgrep.888
-rw-r--r--debian/manpages/exiqsumm.874
-rw-r--r--debian/manpages/exiwhat.8102
-rw-r--r--debian/manpages/update-exim4.conf.8346
-rw-r--r--debian/manpages/update-exim4.conf.template.892
-rw-r--r--debian/manpages/update-exim4defaults.8173
16 files changed, 2095 insertions, 0 deletions
diff --git a/debian/manpages/exicyclog.8 b/debian/manpages/exicyclog.8
new file mode 100644
index 0000000..7b3c759
--- /dev/null
+++ b/debian/manpages/exicyclog.8
@@ -0,0 +1,75 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXICYCLOG 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exicyclog \- Cycle exim's logfiles
+.SH SYNOPSIS
+.B eximcyclog
+.SH DESCRIPTION
+The
+.B exicyclog
+script can be used to cycle (rotate)
+.I mainlog
+and
+.I rejectlog
+files.
+This is not necessary if only syslog is being used.
+Some operating systems have their own standard mechanisms for log cycling,
+and these can be used instead of
+.B exicyclog
+if preferred.
+
+Each time
+.B exicyclog
+is run the file names get \(oqshuffled down\(cq by one.
+If the main log file name is mainlog (the default) then when
+.B exicyclog
+is run mainlog becomes mainlog.01, the previous mainlog.01 becomes mainlog.02
+and so on, up to a limit which is set in the script, and which defaults to 10.
+Reject logs are handled similarly.
+
+If no mainlog file exists, the script does nothing.
+Files that \(oqdrop off\(cq the end are deleted.
+All files with numbers greater than 01 are compressed, using a compression
+command which is configured by the COMPRESS_COMMAND setting in
+Local/Makefile.
+It is usual to run \(lqexicyclog\(rq daily from a root \(lqcrontab\(rq entry
+of the form
+
+ 1 0 * * * su exim \-c /usr/exim/bin/exicyclog
+
+assuming you have used the name \(oqexim\(cq for the Exim user.
+You can run
+.B exicyclog
+as root if you wish, but there is no need.
+
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exigrep.8 b/debian/manpages/exigrep.8
new file mode 100644
index 0000000..f12668b
--- /dev/null
+++ b/debian/manpages/exigrep.8
@@ -0,0 +1,70 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIGREP 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+EXIGREP \- Search Exim's main log
+.SH SYNOPSIS
+.B exigrep
+.I [\-l] pattern [log file] ...
+
+.SH DESCRIPTION
+The
+.B exigrep
+utility is a Perl script that searches one or more main log files for
+entries that match a given pattern.
+When it finds a match, it extracts all the log entries for the relevant
+message, not just those that match the pattern.
+Thus,
+.B exigrep
+can extract complete log entries for a given message, or all mail for a given
+user, or for a given host, for example.
+
+The
+.I \-l
+flag means \(oqliteral\(cq, that is, treat all characters in the pattern as
+standing for themselves.
+Otherwise the pattern must be a Perl regular expression.
+The pattern match is case-insensitive.
+If no file names are given on the command line, the standard input is
+read.
+
+If the location of a
+.B zcat
+command is known from the definition of ZCAT_COMMAND in Local/Makefile,
+.B exigrep
+automatically passes any file whose
+name ends in COMPRESS_SUFFIX through
+.B zcat
+as it searches it.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+.BR perlre (1),
+/usr/share/doc/exim4\-base/
+
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exim4-config_files.5 b/debian/manpages/exim4-config_files.5
new file mode 100644
index 0000000..b217377
--- /dev/null
+++ b/debian/manpages/exim4-config_files.5
@@ -0,0 +1,364 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM4-CONFIG_FILES 5 "Jan 4, 2015" EXIM4
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim4-config_files \- Files in use by the Debian exim4 packages
+.SH SYNOPSIS
+.br
+/etc/aliases
+.br
+/etc/email\-addresses
+.br
+/etc/exim4/local_host_blacklist
+.br
+/etc/exim4/host_local_deny_exceptions
+.br
+/etc/exim4/local_sender_blacklist
+.br
+/etc/exim4/sender_local_deny_exceptions
+.br
+/etc/exim4/local_sender_callout
+.br
+/etc/exim4/local_rcpt_callout
+.br
+/etc/exim4/local_domain_dnsbl_whitelist
+.br
+/etc/exim4/hubbed_hosts
+.br
+/etc/exim4/passwd
+.br
+/etc/exim4/passwd.client
+.br
+/etc/exim4/exim.crt
+.br
+/etc/exim4/exim.key
+.SH DESCRIPTION
+This manual page describes the files that are in use by the Debian
+exim4 packages and which are not part of an exim installation done
+from source.
+.SH /etc/aliases
+is a table providing a mechanism to redirect mail for local
+recipients. /etc/aliases is a text file which is roughly compatible
+with Sendmail. The file should contain lines of the form
+.br
+name: address, address, ...
+.br
+The name is a local address without domain part. All local domains are
+handled equally. For more detailed documentation, please refer to
+/usr/share/doc/exim4\-base/spec.txt.gz, chapter 22, and to
+/usr/share/doc/exim4\-base/README.Debian.gz. Please note that it
+is not possible to use delivery to arbitrary files, directories and to
+pipes. This is forbidden in Debian's exim4 default configuration.
+
+You should at least set up an alias for postmaster in the /etc/aliases
+file.
+.SH /etc/email\-addresses
+is used to rewrite the email addresses of users. This is particularly
+useful for users who use their ISP's domain for email.
+
+The file should contain lines of the form
+
+.br
+user: someone@isp.com
+.br
+otheruser: someoneelse@anotherisp.com
+
+This way emails from user will appear to be from someone@isp.com to
+the outside world. Technically, the from, reply\-to, and sender
+addresses, along with the envelope sender, are rewritten for users that
+appear to be in the local domain.
+
+.SH /etc/exim4/local_host_blacklist
+.I [exim host list]
+is an optional file containing a list of IP addresses, networks and
+host names whose messages will be denied with the error message
+"locally blacklisted". This is a full exim 4 host list, and all
+available features can be used. This includes negative items, and so
+it is possible to exclude addresses from being blacklisted. For
+convenience, as an additional method to whitelist addresses from being
+blocked, an explicit whitelist is read in from
+/etc/exim4/host_local_deny_exceptions. Entries in the whitelist override
+corresponding blacklist entries.
+
+In the blacklist, the trick is to read a line break as "or" if it
+follows a positive item, and as "and" if it follows a negative item.
+
+For example, a /etc/exim4/local_host_blacklist
+
+.br
+192.168.10.0/24
+.br
+!172.16.10.128/26
+.br
+172.16.10.0/24
+.br
+10.0.0.0/8
+
+Exim just evaluates left to right (or up-down in the file listing
+context), so you don't get the same kind of operator binding as in a
+programming language.
+
+.SH /etc/exim4/host_local_deny_exceptions
+.I [exim host list]
+contains a list of IP addresses, networks and host names whose
+messages will be accepted despite the address is also listed in
+/etc/exim4/local_host_blacklist, overriding a blacklisting.
+
+.SH /etc/exim4/local_sender_blacklist
+.I [exim address list]
+is an optional files containing a list of envelope senders whose
+messages will be denied with the error message "locally blacklisted".
+This is a full exim 4 address list, and all available features can be
+used. This includes negative items, and so it is possible to exclude
+addresses from being blacklisted. For convenience, as an additional
+method to whitelist addresses from being blocked, an explicit
+whitelist is read in from /etc/exim4/sender_local_deny_exceptions. Entries
+in the whitelist override corresponding blacklist entries.
+
+In the blacklist, the trick is to read a line break as "or" if it
+follows a positive item, and as "and" if it follows a negative item.
+
+For example, a /etc/exim4/local_sender_blacklist
+
+.br
+domain1.example
+.br
+!local@domain2.example
+.br
+domain2.example
+.br
+domain3.example
+
+Exim just evaluates left to right (or up-down in the file listing
+context), so you don't get the same kind of operator binding as in a
+programming language.
+
+.SH /etc/exim4/sender_local_deny_exceptions
+.I [exim address list]
+is an optional file containing a list of envelope senders whose messages
+will be accepted despite the address being also listed in
+/etc/exim4/local_sender_blacklist, overriding a blacklisting.
+
+.SH /etc/exim4/local_sender_callout
+.I [exim address list]
+is an optional file containing a list of envelope senders whose
+messages are subject to sender verification with a callout. This is a
+full exim4 address list, and all available features can be used.
+
+.SH /etc/exim4/local_rcpt_callout
+.I [exim address list]
+is an optional file containing a list of envelope recipients for which
+incoming messages are subject to recipient verification with a
+callout. This is a full exim4 address list, and all available features
+can be used.
+
+.SH /etc/exim4/local_domain_dnsbl_whitelist
+.I [exim address list]
+is an optional file containing a list of envelope senders whose
+messages are exempt from blacklisting via a domain-based DNSBL. This
+is a full exim4 address list, and all available features can be used.
+This feature is intended to be used in case of a domain-based DNSBL
+being too heavy handed, for example listing entire top-level domains
+for their registry policies.
+
+.SH /etc/exim4/hubbed_hosts
+.I [exim domain list]
+is an optional file containing a list of route_data records which can
+be used to override or augment MX information from the DNS. This is
+particularly useful for mail hubs which are highest-priority MX for a
+domain in the DNS but are not final destination of the messages,
+passing them on to a host which is not publicly reachable, or to
+temporarily fix mail routing in case of broken DNS setups.
+
+The file should contain key-value pairs of domain pattern and route
+data of the form
+
+.br
+domain: host-list options
+.br
+dict.ref.example: mail\-1.ref.example:mail\-2.ref.example
+.br
+foo.example: internal.mail.example.com
+.br
+bar.example: 192.168.183.3
+
+which will cause mail for foo.example to be sent to the host
+internal.mail.example (IP address derived from A record only), and
+mail to bar.example to be sent to 192.168.183.3.
+
+See spec.txt chapter 20.3 through 20.7 for a more detailed explanation
+of host list format and available options.
+
+.SH /etc/exim4/passwd
+contains account and password data for SMTP authentication when the
+local exim is SMTP server and clients authenticate to the local exim.
+
+The file should contain lines of the form
+
+.br
+username:crypted-password:clear-password
+
+crypted-password is the crypt(3)-created hash of your password. You
+can, for example, use the mkpasswd program from the whois package to
+create a crypted password. It is recommended to use a modern hash
+algorithm, see mkpasswd \-\-method=help. Consider not using crypt or MD5.
+
+clear-password is only necessary if you want to offer CRAM-MD5
+authentication. If you don't plan on doing so, the third column can be
+omitted completely.
+
+This file must be readable for the Debian\-exim user and should not be
+readable for others. Recommended file mode is root:Debian\-exim 640.
+
+.SH /etc/exim4/passwd.client
+contains account and password data for SMTP authentication when exim
+is authenticating as a client to some remote server.
+
+The file should contain lines of the form
+
+.br
+target.mail.server.example:login-user-name:password
+
+which will cause exim to use login-user-name and password when sending
+messages to a server with the canonical host name
+target.mail.server.example. Please note that this does not configure
+the mail server to send to (this is determined in Debconf), but only
+creates the correlation between host name and authentication
+credentials to avoid exposing passwords to the wrong host.
+
+Please note that target.mail.server.example is currently the value
+that exim can read from reverse DNS: It first follows the host name of
+the target system until it finds an IP address, and then looks up the
+reverse DNS for that IP address to use the outcome of this query (or
+the IP address itself should the query fail) as index into
+/etc/exim4/passwd.client.
+
+This goes inevitably wrong if the host name of the mail server is a
+CNAME (a DNS alias), or the reverse lookup does not fit the forward one.
+
+Currently, you need to manually lookup all reverse DNS names for all
+IP addresses that your SMTP server host name points to, for example by
+using the host command. If the SMTP smarthost alias expands to
+multiple IPs, you need to have multiple lines for all the hosts. When
+your ISP changes the alias, you will need to manually fix that.
+
+You may minimize this trouble by using a wild card entry or regular
+expressions, thus reducing the risk of divulging the password to the
+wrong SMTP server while reducing the number of necessary lines. For a
+deeper discussion, see the Debian BTS #244724.
+
+password is your SMTP password in clear text. If you do not know about
+your SMTP password, you can try using your POP3 password as a first
+guess.
+
+This file must be readable for the Debian\-exim user and should not be
+readable for others. Recommended file mode is root:Debian\-exim 640.
+
+.br
+# example for CONFDIR/passwd.client
+.br
+# this will only match if the server's generic name matches exactly
+.br
+mail.server.example:user:password
+.br
+# this will deliver the password to any server
+.br
+*:username:password
+.br
+# this will deliver the password to servers whose generic name ends in
+.br
+# mail.server.example
+.br
+*.mail.server.example:user:password
+.br
+# this will deliver the password to servers whose generic name matches
+.br
+# the regular expression
+.br
+^smtp[0\-9]*\\.mail\\.server\\.example:user:password
+.br
+
+.SH /etc/exim4/exim.crt
+contains the certificate that exim uses to initiate TLS connections.
+This is public information and can be world readable.
+/usr/share/doc/exim4\-base/examples/exim\-gencert can
+be used to generate a private key and self-signed certificate.
+
+.SH /etc/exim4/exim.key
+contains the private key belonging to the certificate in exim.crt.
+This file's contents must be kept secret and should have mode
+root:Debian\-exim 640. /usr/share/doc/exim4\-base/examples/exim\-gencert
+can be used to generate a private key and self-signed certificate.
+
+.SH BUGS
+Plenty. Please report them through the Debian BTS
+
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH NOTES
+.SS Unresolvable items in host lists
+
+Adding or keeping items in the abovementioned host lists which are not
+resolvable by DNS has severe consequences.
+
+e.g. if resolving a
+.B hostname
+in local_host_blacklist returns a temporary error (DNS timeout) exim
+will not be able to check whether a connecting host is part of the list.
+Exim will therefore return a temporary SMTP error for
+.I every
+connecting host.
+
+On the other hand if there is a permanent error in resolving a name in the
+host list (the record was removed from DNS) exim behaves as if the host
+does not match the list. e.g. a local_host_blacklist consisting of
+
+notresolvable.example.com:rejectme.example.com
+
+is equivalent to an empty one. - Exim tries to match the IP-address of the
+connecting host to notresolvable.example.com, resolving this IP by DNS
+fails, exim behaves as if the connecting host does not match the list. List
+processing stops at this point!
+
+Starting the list with the special pattern +ignore_unknown as a
+safeguard against this behavior is strongly recommended if hostnames are
+used in hostlists.
+
+See Exim specification Chapter
+.I Domain, host, address, and local part lists
+, section
+.I Behaviour when an IP address or name cannot be found.
+<http://www.exim.org/exim\-html\-current/doc/html/spec_html/ch\-domain_host_address_and_local_part_lists.html>
+
+.SH SEE ALSO
+.br
+.BR exim (8),
+.br
+.BR update\-exim4.conf(8),
+.br
+.BR /usr/share/doc/exim4\-base/,
+.br
+and for general notes and details about interaction with debconf
+.BR /usr/share/doc/exim4\-base/README.Debian.gz
+
+.SH AUTHOR
+Marc Haber <mh+debian-packages@zugschlus.de> with help from Ross Boylan.
+
diff --git a/debian/manpages/exim_checkaccess.8 b/debian/manpages/exim_checkaccess.8
new file mode 100644
index 0000000..5a32d22
--- /dev/null
+++ b/debian/manpages/exim_checkaccess.8
@@ -0,0 +1,80 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM_CHECKACCESS 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim_checkaccess \- Check address acceptance from given IP
+.SH SYNOPSIS
+.B exim_checkaccess
+.I IP-address email@address [more Exim options]
+
+.SH DESCRIPTION
+.B Exim's
+.I \-bh
+command line argument allows you to run a fake SMTP session with debugging
+output, in order to check what Exim is doing when it is applying policy
+controls to incoming SMTP mail.
+However, not everybody is sufficiently familiar with the SMTP protocol to
+be able to make full use of \-bh, and sometimes you just want to answer the
+question \(lqDoes this address have access?\(rq without bothering with any
+further details.
+
+The
+.B exim_checkaccess
+utility is a \(oqpackaged\(cq version of
+.I \-bh.
+It takes two arguments, an IP address and an email address:
+
+ exim_checkaccess 10.9.8.7 A.User@a.domain.example
+
+The utility runs a call to
+.B Exim
+with the \-bh option, to test whether the given email address would be
+accepted in a RCPT command in a TCP/IP connection from the host with the
+given IP address.
+The output of the utility is either the word \(oqaccepted\(cq, or the SMTP error
+response, for example:
+
+ Rejected:
+ 550 Relay not permitted
+
+When running this test, the utility uses \(lq<>\(rq as the envelope sender
+address for the MAIL command, but you can change this by providing additional
+options. These are passed directly to the Exim command.
+For example, to specify that the test is to be run with the sender address
+\(lqhimself@there.example\(rq you can use:
+
+ exim_checkaccess 10.9.8.7 A.User@a.domain.example \\
+ \-f himself@there.example
+
+Note that these additional Exim command line items must be given after the
+two mandatory arguments.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exim_convert4r4.8 b/debian/manpages/exim_convert4r4.8
new file mode 100644
index 0000000..dbe62b8
--- /dev/null
+++ b/debian/manpages/exim_convert4r4.8
@@ -0,0 +1,73 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM_CONVERT4R4 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim_convert4r4 \- Convert Exim configuration from v3 to v4 format
+.SH SYNOPSIS
+.B exim_convert4r4
+
+.SH DESCRIPTION
+This script is provided to assist in updating Exim configuration files.
+It reads an Exim 3 configuration file on the standard input, and writes a
+modified file on the standard output.
+It also writes comments about what it has done to the standard error file.
+It assumes that the input is a valid Exim 3 configuration file.
+A typical call to the conversion script might be
+
+.I exim_convert4r4 < /etc/exim/exim.conf > /etc/exim4/exim4.conf.new
+
+The output file
+.B MUST
+be checked and tested before trying to use it on a live system.
+The conversion script is just an aid which does a lot of the \(lqgrunt
+work\(rq.
+It does not guarantee to produce an Exim 4 configuration that behaves
+exactly the same as the Exim 3 configuration it reads.
+
+Each option change in the new file is preceded by an identifying comment.
+In fact, the conversion script tends to make quite a mess of your
+configuration, and you should expect to go through it afterwards and tidy
+it up by hand.
+
+Unless you are running a very straightforward configuration, the automatic
+conversion is likely to generate a non-optimal configuration.
+You should not only check it thoroughly, but also run as many tests as you
+can, to ensure that it is working as you expect.
+In particular, you should test address routing, using \-bt and \-bv, and the
+policy controls, using \-bh.
+If possible, you should also do some live tests (i.e. send and receive
+some messages) before putting Exim 4 into service.
+
+If you have a very complicated configuration, it is possible that
+exim_convert4r4 will break it in some situations, which is why thorough
+testing is strongly recommended.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+the files in /usr/share/doc/exim4\-base/, especially Exim4.upgrade.gz
+
+.SH AUTHOR
+This manual page was stitched together from Exim4.upgrade by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exim_db.8 b/debian/manpages/exim_db.8
new file mode 100644
index 0000000..1e25aa2
--- /dev/null
+++ b/debian/manpages/exim_db.8
@@ -0,0 +1,193 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM_DB 8 "December 26, 2012"
+.\" Please adjust this date whenever revising the manpage.
+.\" Up to date for 4.80
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim_db \- Exim's hint databases maintenance (exim_dumpdb, exim_fixdb, exim_tidydb)
+.SH SYNOPSIS
+.B exim_dumpdb
+.I spooldir database
+.br
+.B exim_fixdb
+.I spooldir database
+.br
+.B exim_tidydb
+.I [\-f] [\-t time] spooldir database
+
+.SH DESCRIPTION
+Three utility programs are provided for maintaining the DBM files that
+Exim uses to contain its delivery hint information.
+Each program requires two arguments.
+The first specifies the name of Exim's spool directory, and the second is
+the name of the database it is to operate on.
+These are as follows:
+.TP
+.B retry
+the database of retry information
+.TP
+.B wait\-<transport name>
+databases of information about messages waiting for remote hosts
+.TP
+.B callout
+the callout cache
+.TP
+.B ratelimit
+the data for implementing the ratelimit ACL condition
+.TP
+.B misc
+other hints data (for example, for serializing ETRN runs)
+.P
+The entire contents of a database are written to the standard output by the
+.B exim_dumpdb
+program, which has no options or arguments other than the spool
+and database names.
+For example, to dump the retry database:
+
+.I exim_dumpdb /var/spool/exim4 retry
+
+Two lines of output are produced for each entry:
+.nf
+ T:mail.ref.example:192.168.242.242 146 77 Connection refused
+ 31-Oct-1995 12:00:12 02-Nov-1995 12:21:39 02-Nov-1995 20:21:39 *
+
+.fi
+The first item on the first line is the key of the record.
+It starts with one of the letters R, or T, depending on whether it refers
+to a routing or transport retry.
+For a local delivery, the next part is the local address; for a remote
+delivery it is the name of the remote host, followed by its failing IP
+address (unless \(lqretry_include_ip_address\(rq is set false on the smtp
+transport). If the remote port is not the standard one (port 25), it is
+added to the IP address.
+Then there follows an error code, an additional error code, and a
+textual description of the error.
+
+The three times on the second line are the time of first failure, the time of
+the last delivery attempt, and the computed time for the next attempt.
+The line ends with an asterisk if the cutoff time for the last retry rule
+has been exceeded.
+
+Each output line from
+.B exim_dumpdb
+for the
+.I wait\-xxx
+databases consists of a host name followed by a list of ids for messages
+that are or were waiting to be delivered to that host.
+If there are a very large number for any one host, continuation records,
+with a sequence number added to the host name, may be seen.
+The data in these records is often out of date, because a message may be
+routed to several alternative hosts, and Exim makes no effort to keep
+cross-references.
+
+The
+.B exim_tidydb
+utility program is used to tidy up the contents of a hints database.
+If run with no options, it removes all records that are more than 30 days
+old. The age is calculated from the date and time that the record was last
+updated. Note that, in the case of the retry database, it is not the time
+since the first delivery failure. Information about a host that has been
+down for more than 30 days will remain in the database, provided that the
+record is updated sufficiently often.
+
+The cutoff date can be altered by means of the \-t option, which must be
+followed by a time.
+For example, to remove all records older than a week from the retry
+database:
+
+.I exim_tidydb \-t 7d /var/spool/exim4 retry
+
+Both the
+.I wait\-xxx
+and
+.I retry
+databases contain items that involve message ids.
+In the former these appear as data in records keyed by host - they were
+messages that were waiting for that host - and in the latter they are the
+keys for retry information for messages that have suffered certain types
+of error.
+When \(lqexim_tidydb\(rq is run, a check is made to ensure that message ids in
+database records are those of messages that are still on the queue.
+Message ids for messages that no longer exist are removed from \(lqwait\-\(rqxxx
+records, and if this leaves any records empty, they are deleted.
+For the \(lqretry\(rq database, records whose keys are non-existent message
+ids are removed.
+The
+.B exim_tidydb
+utility outputs comments on the standard output whenever it removes
+information from the database.
+
+Certain records are automatically removed by Exim when they are no longer
+needed, but others are not. For example, if all the MX hosts for a domain
+are down, a retry record is created for each one. If the primary MX host
+comes back first, its record is removed when Exim successfully delivers to
+it, but the records for the others remain because Exim has not tried to use
+those hosts.
+
+It is important, therefore, to run \(lqexim_tidydb\(rq periodically on all
+the hints databases. You should do this at a quiet time of day, because it
+requires a database to be locked (and therefore inaccessible to Exim) while
+it does its work. Removing records from a DBM file does not normally make
+the file smaller, but all the common DBM libraries are able to re-use the
+space that is released. After an initial phase of increasing in size, the
+databases normally reach a point at which they no longer get any bigger, as
+long as they are regularly tidied.
+
+Warning: If you never run \(lqexim_tidydb\(rq, the space used by the hints
+databases is likely to keep on increasing.
+
+The
+.B exim_fixdb
+program is a utility for interactively modifying databases.
+Its main use is for testing Exim, but it might also be occasionally useful
+for getting round problems in a live system.
+It has no options, and its interface is somewhat crude.
+On entry, it prompts for input with a right angle-bracket.
+A key of a database record can then be entered, and the data for that
+record is displayed.
+
+If \(oqd\(cq is typed at the next prompt, the entire record is deleted.
+For all except the
+.I retry
+database, that is the only operation that can be carried out.
+For the
+.I retry
+database, each field is output preceded by a number, and data for individual
+fields can be changed by typing the field number followed by new data, for
+example:
+
+ > 4 951102:1000
+
+resets the time of the next delivery attempt.
+Time values are given as a sequence of digit pairs for year, month, day,
+hour, and minute.
+Colons can be used as optional separators.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exim_dbmbuild.8 b/debian/manpages/exim_dbmbuild.8
new file mode 100644
index 0000000..2b4658a
--- /dev/null
+++ b/debian/manpages/exim_dbmbuild.8
@@ -0,0 +1,105 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM_DBMBUILD 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim_dbmbuild \- Build a DBM file.
+.SH SYNOPSIS
+.B exim_dbmbuild
+.I [\-nolc] [\-nozero] [\-noduperr] [\-nowarn] inputfile|\- outputfile
+
+.SH DESCRIPTION
+The
+.B exim_dbmbuild
+program reads an input file containing keys and data in
+the format used by the
+.I lsearch
+lookup (see section 9.1).
+It writes a DBM file using the lower-cased alias names as keys and the
+remainder of the information as data.
+The lower-casing can be prevented by calling the program with the
+.I \-nolc
+option.
+
+A terminating zero is included as part of the key string.
+This is expected by the dbm lookup type.
+However, if the option
+.I \-nozero
+is given,
+.B exim_dbmbuild
+creates files without terminating zeroes in either the key strings or the
+data strings.
+The
+.I dbmnz
+lookup type can be used with such files.
+
+The program requires two arguments: the name of the input file (which can
+be a single hyphen to indicate the standard input), and the name of the
+output file.
+It creates the output under a temporary name, and then renames it if all
+went well.
+If the native DB interface is in use (USE_DB is set in a compile-time
+configuration file - this is common in free versions of Unix) the two file
+names must be different, because in this mode the Berkeley DB functions
+create a single output file using exactly the name given.
+For example,
+
+ exim_dbmbuild /etc/aliases /etc/aliases.db
+
+reads the system alias file and creates a DBM version of it in
+/etc/aliases.db.
+
+In systems that use the
+.I ndbm
+routines (mostly proprietary versions of Unix), two files are used, with the
+suffixes .dir and .pag.
+In this environment, the suffixes are added to the second argument of
+.B exim_dbmbuild,
+so it can be the same as the first.
+This is also the case when the Berkeley functions are used in
+compatibility mode (though this is not recommended), because in that case
+it adds a .db suffix to the file name.
+
+If a duplicate key is encountered, the program outputs a warning, and when
+it finishes, its return code is 1 rather than zero, unless the
+.I \-noduperr
+option is used.
+By default, only the first of a set of duplicates is used - this makes it
+compatible with lsearch lookups.
+There is an option
+.I \-lastdup
+which causes it to use the data for the last duplicate instead.
+There is also an option
+.I \-nowarn,
+which stops it listing duplicate keys to \(lqstderr\(rq.
+For other errors, where it doesn't actually make a new file, the return
+code is 2.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exim_lock.8 b/debian/manpages/exim_lock.8
new file mode 100644
index 0000000..725084a
--- /dev/null
+++ b/debian/manpages/exim_lock.8
@@ -0,0 +1,137 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIM_LOCK 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exim_lock \- Mailbox maintenance
+.SH SYNOPSIS
+.B exim_lock
+.RI [ options ] mailbox-file
+
+.SH DESCRIPTION
+The
+.B exim_lock
+utility locks a mailbox file using the same algorithm as Exim.
+For a discussion of locking issues, see section 25.2.
+.B exim_lock
+can be used to prevent any modification of a mailbox by Exim or a user
+agent while investigating a problem.
+The utility requires the name of the file as its first argument.
+If the locking is successful, the second argument is run as a command
+(using C's \(lqsystem()\(rq function); if there is no second argument, the value
+of the SHELL environment variable is used; if this is unset or empty,
+/bin/sh is run.
+When the command finishes, the mailbox is unlocked and the utility ends.
+The following options are available:
+.TP
+.I \-fcntl
+Use \(lqfcntl()\(rq locking on the open mailbox.
+.TP
+.I \-interval
+This must be followed by a number, which is a number of seconds; it
+sets the interval to sleep between retries (default 3).
+.TP
+.I \-lockfile
+Create a lock file before opening the mailbox.
+.TP
+.I \-mbx
+Lock the mailbox using MBX rules.
+.TP
+.I \-q
+Suppress verification output.
+.TP
+.I \-retries
+This must be followed by a number; it sets the number of times to try
+to get the lock (default 10).
+.TP
+.I \-timeout
+This must be followed by a number, which is a number of seconds; it
+sets a timeout to be used with a blocking \(lqfcntl()\(rq lock.
+If it is not set (the default), a non-blocking call is used.
+.TP
+.I \-v
+Generate verbose output.
+
+If none of
+.I \-fcntl, \-lockfile
+or
+.I \-mbx
+are given, the default is to create a lock file and also use \(lqfcntl()\(rq locking
+on the mailbox, which is the same as
+.B Exim's
+default.
+The use of
+.I \-fcntl
+requires that the file be writable; the use
+of
+.I \-lockfile
+requires that the directory containing the file be writable.
+Locking by lock file does not last for ever; Exim assumes that a lock file
+is expired if it is more than 30 minutes old.
+
+The
+.I \-mbx
+option is mutually exclusive with
+.I \-fcntl.
+It causes a shared lock to be taken out on the open mailbox, and an
+exclusive lock on the file /tmp/.n.m where n and m are the device number
+and inode number of the mailbox file.
+When the locking is released, if an exclusive lock can be obtained for the
+mailbox, the file in /tmp is deleted.
+
+The default output contains verification of the locking that takes place.
+The
+.I \-v
+option causes some additional information to be given.
+The
+.I \-q
+option suppresses all output except error messages.
+.PP
+A command such as
+
+ exim_lock /var/spool/mail/spqr
+
+runs an interactive shell while the file is locked, whereas
+
+ exim_lock \-q /var/spool/mail/spqr <<End
+ <some commands>
+ End
+
+runs a specific non-interactive sequence of commands while the file is
+locked, suppressing all verification output.
+A single command can be run by a command such as
+
+ exim_lock \-q /var/spool/mail/spqr \
+ "cp /var/spool/mail/spqr /some/where"
+
+Note that if a command is supplied, it must be entirely contained within
+the second argument - hence the quotes.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/eximon.8 b/debian/manpages/eximon.8
new file mode 100644
index 0000000..400d9cd
--- /dev/null
+++ b/debian/manpages/eximon.8
@@ -0,0 +1,50 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIMON 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+eximon \- Monitor Exim
+.SH SYNOPSIS
+.B eximon
+
+.SH DESCRIPTION
+The Exim monitor is an application which displays in an X window information
+about the state of
+.B Exim's
+queue and what
+.B Exim is doing.
+An admin user can perform certain operations on messages from this GUI
+interface; however all such facilities are also available from the command
+line, and indeed, the monitor itself makes use of the command line to
+perform any actions requested.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/.
+Eximon is documented extensivly in the
+.B specification of the exim mail transfer agent.
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exinext.8 b/debian/manpages/exinext.8
new file mode 100644
index 0000000..8aaaf8f
--- /dev/null
+++ b/debian/manpages/exinext.8
@@ -0,0 +1,73 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXINEXT 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exinext \- Finding individual retry times
+.SH SYNOPSIS
+.B exinext
+.I address|message-id
+
+.SH DESCRIPTION
+A utility called
+.B exinext
+(mostly a Perl script) provides the ability to fish specific information
+out of the retry database.
+Given a mail domain (or a complete address), it looks up the hosts for
+that domain, and outputs any retry information for the hosts or for the
+domain.
+At present, the retry information is obtained by running
+.B exim_dumpdb
+(see below) and processing the output.
+For example:
+
+ exinext piglet@milne.fict.example
+ kanga.milne.fict.example:192.168.8.1 error 146: Connection refused
+ first failed: 21-Feb-1996 14:57:34
+ last tried: 21-Feb-1996 14:57:34
+ next try at: 21-Feb-1996 15:02:34
+ roo.milne.fict.example:192.168.8.3 error 146: Connection refused
+ first failed: 20-Jan-1996 13:12:08
+ last tried: 21-Feb-1996 11:42:03
+ next try at: 21-Feb-1996 19:42:03
+ past final cutoff time
+
+You can also give
+.B exinext
+a local part, without a domain, and it will give any retry information for
+that local part in your default domain.
+A message id can be used to obtain retry information pertaining to a
+specific message.
+This exists only when an attempt to deliver a message to a remote host
+suffers a message-specific error (see section 42.2).
+.B exinext
+is not particularly efficient, but then it isn't expected to be run very often.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exiqgrep.8 b/debian/manpages/exiqgrep.8
new file mode 100644
index 0000000..e436237
--- /dev/null
+++ b/debian/manpages/exiqgrep.8
@@ -0,0 +1,88 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIQGREP 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exiqgrep \- Search in the exim queue
+.SH SYNOPSIS
+.B exiqgrep
+.I [\-a] [\-c]
+
+.SH DESCRIPTION
+The
+.B exiqgrep
+utility is a Perl script which offers possibilities to grep in the
+exim queue output. Unlike exiqsumm, it invokes exim \-bpu itself and
+does not need to be invoked in a pipe.
+
+.SH OPTIONS
+.TP 10
+\fB\-h\fR
+Print help
+.TP
+\fB\-f <regexp>\fR
+Match sender address (field is \(lq< >\(rq wrapped)
+.TP
+\fB\-r <regexp>\fR
+Match recipient address
+.TP
+\fB\-s <regexp>\fR
+Match against the site field from long output
+.TP
+\fB\-y <seconds>\fR
+Message younger than
+.TP
+\fB\-o <seconds>\fR
+Message older than
+.TP
+\fB\-z\fR
+Frozen messages only (exclude non-frozen)
+.TP
+\fB\-x\fR
+Non-frozen messages only (exclude frozen)
+.TP
+\fB\-c\fR
+Display match count
+.TP
+\fB\-l\fR
+Long Format [Default]
+.TP
+\fB\-i\fR
+Message IDs only
+.TP
+\fB\-b\fR
+Brief Format
+.TP
+\fB\-R\fR
+Reverse order
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from the source code by Marc
+Haber <mh+debian\-packages@zugschlus.de>, using the exiqsumm man page by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
+
diff --git a/debian/manpages/exiqsumm.8 b/debian/manpages/exiqsumm.8
new file mode 100644
index 0000000..e228320
--- /dev/null
+++ b/debian/manpages/exiqsumm.8
@@ -0,0 +1,74 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIQSUMM 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exiqsumm \- Summarising the queue
+.SH SYNOPSIS
+.B exiqsumm
+.I [\-a] [\-c]
+
+.SH DESCRIPTION
+The
+.B exiqsumm
+utility is a Perl script which reads the output of
+.I exim \-bp
+and produces a summary of the messages on the queue.
+Thus, you use it by running a command such as
+
+ exim \-bp | exiqsumm
+
+The output consists of one line for each domain that has messages waiting
+for it, as in the following example:
+
+ 3 2322 74m 66m msn.com.example
+
+This lists the number of messages for the domain, their total volume, and
+the length of time that the oldest and the newest messages have been
+waiting.
+By default the output is sorted on the domain name, but
+.B exiqsumm
+has the options
+.I \-a
+and
+.I \-c,
+which cause the output to be sorted by oldest message and by count of
+messages, respectively.
+
+The output of
+.I exim \-bp
+contains the original addresses in the message, so this also applies to
+the output from
+.B exiqsumm.
+No domains from addresses generated by aliasing or forwarding are included
+(unless the \(lqone_time\(rq option of the redirect router has been used to
+convert them into \(oqtop level\(cq addresses).
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/exiwhat.8 b/debian/manpages/exiwhat.8
new file mode 100644
index 0000000..ca727e6
--- /dev/null
+++ b/debian/manpages/exiwhat.8
@@ -0,0 +1,102 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH EXIWHAT 8 "March 26, 2003"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+exiwhat \- Finding out what Exim processes are doing
+.SH SYNOPSIS
+.B exiwhat
+
+.SH DESCRIPTION
+On operating systems that can restart a system call after receiving a
+signal (most modern OS), an
+.B Exim
+process responds to the SIGUSR1 signal by writing a line describing what
+it is doing to the file exim\-process.info in the Exim spool directory.
+The
+.B exiwhat
+script sends the signal to all
+.B Exim
+processes it can find, having first emptied the file.
+It then waits for one second to allow the
+.B Exim
+processes to react before displaying the results.
+In order to run
+.B exiwhat
+successfully you have to have sufficient privilege to send the signal to
+the
+.B Exim
+processes, so it is normally run as root.
+
+Unfortunately, the
+.B ps
+command which
+.B exiwhat
+uses to find
+.B Exim
+processes varies in different operating systems.
+Not only are different options used, but the format of the output is
+different.
+For this reason, there are some system configuration options that configure
+exactly how
+.B exiwhat
+works.
+If it doesn't seem to be working for you, check the following compile-time
+options:
+.TP
+.I EXIWHAT_PS_CMD
+the command for running \(lqps\(rq
+.TP
+.I EXIWHAT_PS_ARG
+the argument for \(lqps\(rq
+.TP
+.I EXIWHAT_EGREP_ARG
+the argument for \(lqegrep\(rq to select from \(lqps\(rq output
+.TP
+.I EXIWHAT_KILL_ARG
+the argument for the \(lqkill\(rq command
+.PP
+An example of typical output from
+.B exiwhat
+is
+
+.nf
+ 164 daemon: \-q1h, listening on port 25
+10483 running queue: waiting for 0tAycK-0002ij-00 (10492)
+10492 delivering 0tAycK-0002ij-00 to mail.ref.example [10.19.42.42]
+ (editor@ref.example)
+10592 handling incoming call from [192.168.243.242]
+10628 accepting a local non-SMTP message
+.fi
+
+The first number in the output line is the process number.
+The third line has been split here, in order to fit it on the page.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+This manual page was stitched together from spec.txt by
+Andreas Metzler <ametzler at downhill.at.eu.org>,
+for the Debian GNU/Linux system (but may be used by others).
diff --git a/debian/manpages/update-exim4.conf.8 b/debian/manpages/update-exim4.conf.8
new file mode 100644
index 0000000..9a4efcb
--- /dev/null
+++ b/debian/manpages/update-exim4.conf.8
@@ -0,0 +1,346 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH UPDATE-EXIM4.CONF 8 "Jun 25, 2005" EXIM4
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+update\-exim4.conf \- Generate exim4 configuration files.
+
+.SH SYNOPSIS
+.B update\-exim4.conf [\-v|\-\-verbose] [\-h|\-\-help] [\-\-keepcomments] [\-\-removecomments] [\-o|\-\-output file]
+
+.SH OPTIONS
+.TP
+.I \-\-check
+Generate temporary configuration file, check its validity and exit with
+either success (exitcode 0) or an error (exitcode 1). On success the
+temporary file is deleted, otherwise the file is left for further
+debugging.
+.TP
+.I \-d|\-\-confdir directory
+Read input from directory instead of /etc/exim4.
+.TP
+.I \-h|\-\-help
+Show short help message and exit
+.TP
+.I \-\-keepcomments
+Do not remove comment lines from the output file.
+.TP
+.I \-o|\-\-output file
+Write output to file instead of /var/lib/exim4/config.autogenerated.
+.TP
+.I \-\-removecomments
+Remove comment lines from the output file. [Default]
+.TP
+.I \-v|\-\-verbose
+Enable verbose mode
+
+.SH DESCRIPTION
+The script
+.B update\-exim4.conf
+generates the main configuration files
+.I /var/lib/exim4/config.autogenerated
+for
+.B Exim v4
+by merging the data in the template file
+.I /etc/exim4/exim4.conf.template
+or the ones in the
+.I /etc/exim4/conf.d
+directory tree respectively and
+.I /etc/exim4/update\-exim4.conf.conf
+to the output file
+.I /var/lib/exim4/config.autogenerated.
+.PP
+If dc_use_split_config in /etc/exim4/update\-exim4.conf.conf specifies a split
+configuration,
+.B update\-exim4.conf
+processes the /etc/exim4/conf.d subdirectories in the order main, acl,
+router, transport, retry, rewrite and auth. Within each directory it takes
+files in lexical sort order by file name. It concatenates all these files
+and makes the debconf replacement described below.
+
+If you are not using split configuration
+.B update\-exim4.conf
+concatenates
+/etc/exim4/exim4.conf.localmacros
+(if this file exists) and /etc/exim4/exim4.conf.template (in this order) and
+makes the debconf replacement described below.
+
+In either case, before outputting the result
+to /var/lib/exim4/config.autogenerated,
+.B update\-exim4.conf
+generates a number of exim configuration macros from the contents of
+dc_something from /etc/exim4/update\-exim4.conf.conf and inserts them
+into the configuration right after the definition of the exim
+configuration macro UPEX4CmacrosUPEX4C (which is only used as
+placeholder for this case). The macro definitions are bracketed
+with .ifdef clauses to allow the local admin to override the values with
+earlier definitions.
+.B update\-exim4.conf
+makes no other changes to the configuration.
+This makes it very simple to make small changes to the configuration and
+still have the benefits of debconf.
+
+On the other hand if you don't want to manage exim4.conf with debconf
+install your own handcrafted version as /etc/exim4/exim4.conf.
+Exim will use this file if it exists and ignore the autogenerated one.
+Additionally you might want to set
+.I dc_eximconfig_configtype=none
+in /etc/exim4/update\-exim4.conf.conf to stop debconf from asking you questions about exim4.
+
+.B update\-exim4.conf
+exits silently and does nothing if /etc/exim4/exim4.conf exists and \-o
+was not used to direct the output to a different file than
+/var/lib/exim4/config.autogenerated.
+
+.B update\-exim4.conf
+will only use files in the conf.d directory that have a filename which
+consists only of letters, numbers, underscores and hyphens
+([:alnum:]_\-), similar to
+.B run\-parts(8).
+Additionally,
+.B update\-exim4.conf
+will use /etc/exim4/conf.d/foo/bar.rul instead of
+/etc/exim4/conf.d/foo/bar if the .rul file exists. This is meant to be
+helpful for easy interaction with packages extending Exim.
+
+If the new configuration will be written to
+/var/lib/exim4/config.autogenerated,
+.B update\-exim4.conf
+will check the validity of the freshly generated configuration. If
+the new file is detected as invalid, update-exim4.conf leaves the old
+/var/lib/exim4/config.autogenerated untouched and exits with an error.
+
+However, there are still possible invalidities that can only be
+detected at run time. This most notably applies to errors in
+expressions that are expanded at run time.
+
+If the new configuration will be written to some other file, no
+validity checking occurs and that file will always be overwritten.
+
+.SH EXAMPLES
+You want to be able to check exim's queue as normal user: Generate a new
+file, e.g. /etc/exim4/conf.d/main/40_local_mailq, containing only the line
+.I queue_list_requires_admin = false
+
+.SH NOTES
+.B update\-exim4.conf
+changes the file permissions of the output file to the value of the environment
+variable CFILEMODE. If CFILEMODE is neither set in
+/etc/exim4/update\-exim4.conf.conf nor in the environment it defaults to 0644.
+Change this to 0640 if you are keeping sensitive information (LDAP credentials
+et. al.) in there.
+
+.SH CONFIGURATION VARIABLES
+All lists given in configuration variables are semicolon-separated. In
+the past, they used to be colon separated. This was changed to
+semicolon separation to make specification of IPv6 addresses easier.
+Backwards compatibility is preserved, so that old configurations using
+colons as separators do still work. Colons are deprecated and might
+stop working in a later release. If you need to specify a single IPv6
+address in a field that is defined as a list of host names or IP
+addresses, please prefix "<;" to explicitly specify the list separator
+as a semicolon. Otherwise, the code cannot tell an IP address from a
+colon-separated list of strange host names.
+
+Using lookups like "dsearch;something" in update-exim4.conf.conf has
+never been supported and does no longer work! If you need this, please
+convert to directly setting the appropriate macros.
+
+.B update\-exim4.conf
+evaluates these patterns in
+.B /etc/exim4/update\-exim4.conf.conf:
+.TP
+.I CFILEMODE
+The octal file mode of the generated file.
+.TP
+.I dc_eximconfig_configtype
+The main configuration type. Sets macro DC_eximconfig_configtype. The macro
+usually contains a shorthand for one of the choices for the
+\(lqGeneral type of mail configuration\(rq debconf question (See
+README.Debian).
+
+.RS
+.B dc_eximconfig_configtype <-> debconf configtype mapping:
+.PD 0.1
+.TP
+\(lqinternet\(rq
+internet site; mail is sent and received directly using SMTP
+.TP
+\(lqsmarthost\(rq
+mail sent by smarthost; received via SMTP or fetchmail
+.TP
+\(lqsatellite\(rq
+mail sent by smarthost; no local mail
+.TP
+\(lqlocal\(rq
+local delivery only; not on a network
+.TP
+\(lqnone\(rq
+no configuration at this time
+.PD
+.RE
+
+.TP
+.I dc_hide_mailname
+Boolean option that controls whether the local mailname in the headers of
+outgoing mail should be hidden. (Only effective for \(lqsmarthost\(rq and
+\(lqsatellite\(rq. Sets macro HIDE_MAILNAME.
+.TP
+.I dc_mailname_in_oh
+Internal use only Boolean option that is set by the maintainer scripts
+after adding the contents of /etc/mailname to the dc_other_hostnames
+list. This is a transition helper since it wouldn't otherwise be
+possible to see whether that domain name has been removed from
+dc_other_hostnames on purpose. This is not used by update-exim4.conf,
+and no macro is set.
+.TP
+.I ue4c_keepcomments
+Boolean option that controls whether
+.B update\-exim4.conf
+strips the comments from the target configuration file (default) or
+leaves them in. This can be overridden by the command line options
+\-\-keepcomments and \-\-removecomments. The value is not written to an
+exim macro.
+.TP
+.I dc_localdelivery
+name of the default transport for local mail delivery. Defaults to mail_spool
+if unset, use maildir_home for delivery to ~/Maildir/. Sets macro
+LOCAL_DELIVERY.
+.TP
+.I dc_local_interfaces
+List of IP addresses the Exim daemon should listen on. If this is left
+empty, Exim listens on all interfaces. Sets macro
+MAIN_LOCAL_INTERFACES only if there is a non-empty value.
+.TP
+.I dc_minimaldns
+Boolean option to activate some option to minimize DNS lookups, if set to
+\(lqtrue\(rq a macro DC_minimaldns is defined. If true, the macro
+DC_minimaldns is set to 1, and the macro
+MAIN_HARDCODE_PRIMARY_HOSTNAME is set to the appropriately
+post-processes output of hostname \-\-fqdn.
+.TP
+.I dc_other_hostnames
+is used to build the local_domains list, together with \(lqlocalhost\(rq.
+This is the list of domains for which this machine should
+consider itself the final destination. The local_domains list ends up
+in the macro MAIN_LOCAL_DOMAINS.
+.TP
+.I dc_readhost
+For \(lqsmarthost\(rq and \(lqsatellite\(rq it is possible to hide the local
+mailname in the headers of outgoing mail and replace it with this value
+instead, using rewriting. For \(lqsatellite\(rq only, this value is
+also the host to send local mail to. Sets macro DCreadhost.
+.TP
+.I dc_relay_domains
+is a list of domains for which we accept mail from anywhere on the
+Internet but which are not delivered locally, e.g. because this machine
+serves as secondary MX for these domains. Sets MAIN_RELAY_TO_DOMAINS.
+.TP
+.I dc_relay_nets
+A list of machines for which we serve as smarthost. Please note that
+127.0.0.1 and ::1 are always permitted to relay since /usr/lib/sendmail
+is available anyway and relay control doesn't make sense here. Sets
+macro MAIN_RELAY_NETS.
+.TP
+.I dc_smarthost
+List of hosts to which all outgoing mail is passed to and that takes care
+of delivering it. Each of the hosts is tried, in the order specified
+(See exim specification, chapter 20.5). All deliveries go out to TCP
+port 25 unless a different port is specified after the host name,
+separated from the host name by two colons. Colons in IPv6 addresses need
+to be doubled. If a port number follows, IP addresses may be enclosed in
+brackets, which might be the only possibility to specify delivery to an
+IPv6 address and a different port. Examples:
+.br
+.BR host.domain.example
+deliver to host looked up on DNS, tcp/25
+.br
+.BR host.domain.example::587
+deliver to host looked up on DNS, tcp/587
+.br
+.BR 192.168.2.4
+deliver to IPv4 host, tcp/25
+.br
+.BR 192.168.2.4::587
+deliver to IPv4 host, tcp/587
+.br
+.BR [192.168.2.4]::587
+deliver to IPv4 host, tcp/587
+.br
+.BR 2001::0db8::f::4::::2
+deliver to IPv6 host, tcp/25
+.br
+.BR [2001::0db8::f::4::::2]::587
+deliver to IPv6 host, tcp/587
+.br
+This is used as value of the DCsmarthost macro.
+.TP
+.I dc_use_split_config
+Boolean option that controls whether
+.B update\-exim4.conf
+uses /etc/exim4/exim4.conf.template (\(lqfalse\(rq) or the multiple files
+below /etc/exim4/conf.d (\(lqtrue\(rq) as input. This does not set any
+macros.
+.TP
+.I The macro MAIN_PACKAGE_VERSION is set to Debian's Version number of
+the package being installed for convenient inclusion in the
+configuration.
+
+.SH RECOMMENDED USAGE
+If you are running exim as daemon (as it is in the default setup of the
+Debian packages) you should not invoke
+.B update\-exim4.conf
+directly when exim is running. For SMTP receiving or queue running,
+exim forks, and the new processes would use the new configuration file,
+while the original main exim daemon would still use the old configuration
+file. You should use
+.I invoke\-rc.d exim4 restart
+instead.
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH FILES
+.LP
+.TP
+.B /var/lib/exim4/config.autogenerated
+Exim's main configuration file
+.LP
+.TP
+.B /etc/exim4/exim4.conf
+Optional manually managed Exim main configuration file. Takes precedence over
+debconf managed one if it exists.
+.LP
+.TP
+.B /etc/exim4/update-exim4.conf.conf
+Configuration file being written by exim4-config maintainer scripts,
+which may be hand-edited, and is read as input by update-exim4.conf.
+
+.SH SEE ALSO
+.BR exim (8),
+.BR exim4-config_files(5),
+/usr/share/doc/exim4\-base/ and for general notes and details about interaction
+with debconf
+/usr/share/doc/exim4\-base/README.Debian.gz
+
+.SH AUTHOR
+Andreas Metzler <ametzler at debian.org>
+.br
+Marc Haber <mh+debian-packages@zugschlus.de>
diff --git a/debian/manpages/update-exim4.conf.template.8 b/debian/manpages/update-exim4.conf.template.8
new file mode 100644
index 0000000..4b65a82
--- /dev/null
+++ b/debian/manpages/update-exim4.conf.template.8
@@ -0,0 +1,92 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH UPDATE-EXIM4.CONF.TEMPLATE 8 "Feb 27, 2005" EXIM4
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+update\-exim4.conf.template \- Regenerate exim4 configuration file template.
+.SH SYNOPSIS
+.B update\-exim4.conf.template [\-h|\-\-help] [\-n|\-\-nobackup] [\-o|\-\-output file] [\-r|\-\-run]
+
+.SH OPTIONS
+.TP
+.I \-h|\-\-help
+Show short help message and exit
+.TP
+.I \-n|\-\-nobackup
+Overwrite existing file, instead of keeping it as
+/etc/exim4/exim4.conf.template.bak.random-number
+.TP
+.I \-o|\-\-output file
+Write output to file instead of /etc/exim4/exim4.conf.template.
+.TP
+.I \-r|\-\-run
+Actually do something. If this option is not specified
+.B update\-exim4.conf.template
+will exit immediately. This option was introduced because
+.B update\-exim4.conf.template
+overwrites configuration files.
+
+.SH DESCRIPTION
+The script
+.B update\-exim4.conf.template
+regenerates the main configuration file template
+.I /etc/exim4/exim4.conf.template
+from the configuration snippets in the
+.I /etc/exim4/conf.d
+directory tree.
+.PP
+This process will overwrite all local changes in
+.I /etc/exim4/exim4.conf.template
+and might be useful if there are local changes in the
+.I /etc/exim4/conf.d
+directory tree, for example by a new mail related package dropping its
+own configuration snippets in there.
+
+.B update\-exim4.conf.template
+ignores all files in the conf.d directory that have a filename which
+does not consist only of letters, numbers, underscores and hyphens
+([:alnum:]_\-), similar to
+.B run\-parts(8).
+For easy interaction with packages extending Exim additionally
+/etc/exim4/conf.d/foo/bar.rul is used instead of
+/etc/exim4/conf.d/foo/bar if it exists!
+
+.SH ENVIRONMENT
+If
+.B CONFDIR
+is set
+.B update\-exim4.conf.template
+will search for the input files below $CONFDIR/conf.d instead of
+/etc/exim4/conf.d/ and will write the output to $CONFDIR/exim4.conf.template
+instead of to /etc/exim4/exim4.conf.template (unless overridden with \-o or
+\-\-output).
+
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim4 (8),
+/usr/share/doc/exim4\-base/ and for general notes and details about interaction
+with debconf
+/usr/share/doc/exim4\-base/README.Debian.gz
+
+.SH AUTHOR
+Marc Haber <mh+debian\-packages@zugschlus.de>
diff --git a/debian/manpages/update-exim4defaults.8 b/debian/manpages/update-exim4defaults.8
new file mode 100644
index 0000000..da74a65
--- /dev/null
+++ b/debian/manpages/update-exim4defaults.8
@@ -0,0 +1,173 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH UPDATE-EXIM4DEFAULTS 8 "March 26, 2003" EXIM4
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" \(oqthis text is enclosed in single quotes\(cq
+.\" \(lqthis text is enclosed in double quotes\(rq
+.SH NAME
+update\-exim4defaults \- Manage exim4 daemon default file.
+.SH SYNOPSIS
+.B update\-exim4defaults
+.I [ \-\-qflags flags ]
+.I [ \-\-queuerunner combined|queueonly|separate|ppp|no|nodaemon ]
+.I [ \-\-queuetime time ]
+.I [ \-\-commonoptions options ]
+.I [ \-\-queuerunneroptions options ]
+.I [ \-\-smtplisteneroptions options ]
+.I [ \-\-remove\-common options ]
+.I [ \-\-remove\-queue options ]
+.I [ \-\-remove\-smtp options ]
+.I [ \-\-force|\-f ]
+.I [ \-\-help|\-h ]
+.I [ \-\-init ]
+
+.SH DESCRIPTION
+.B update\-exim4defaults
+allows one to set run parameters for the
+.B Exim
+daemon in
+.I /etc/default/exim4.
+Its main purpose is for interaction with packages enhancing
+.B Exim
+like virus-scanners that need to change the way the exim daemon is started.
+.PP
+
+.SH OPTIONS
+.TP
+.I \-\-help|\-h
+Print short usage instructions and exit.
+.TP
+.I \-\-qflags flags
+Set qflags, special flags given to exim directly after the \(lq\-q\(rq. See
+.B exim(8)
+for more information.
+.TP
+.I \-\-queuerunner combined|queueonly|separate|ppp|no|nodaemon
+Should the init script start one daemon that listens on the smtp port for
+incoming connections and runs the queue at regular intervals
+.I (combined)
+, or should it start two separate daemons, one listening on the smtp port,
+the other running the queue
+.I (separate)
+, or should the queue only be run by /etc/ppp/ip\-up.d/exim4
+.I (ppp)
+, or shouldn't we run the queue at all, for example if you'd rather do this
+with
+.B cron
+? Or should we only start a queuerunner
+.I (queueonly)
+or no daemon at all
+.I (nodaemon)
+?
+.TP
+.I \-\-queuetime time
+In which intervals should we run the queue? This passed as option
+.I \-q<qflags>time
+to Exim, e.g. \-q30m or \-qq1h.
+.TP
+.I \-\-commonoptions options
+Options passed both to queue\-running and listening instances of Exim.
+.TP
+.I \-\-queuerunneroptions options
+Options only passed to the instance of Exim running the queue.
+.TP
+.I \-\-smtplisteneroptions options
+Options only passed to the instance of Exim listening on the SMTP port.
+.TP
+.I \-\-force|\-f
+Without this option
+.B update\-exim4defaults
+exits with an error if at least one of the options \-\-queuetime,
+\-\-commonoptions, \-\-queuerunneroptions or \-\-smtplisteneroptions is used and the
+corresponding value in /etc/default/exim4 is
+.I already
+set to a nonempty value.
+.TP
+.I \-\-remove\-common option
+Try to remove the given option from COMMONOPTIONS.
+.TP
+.I \-\-remove\-queue option
+Try to remove the given option from QUEUERUNNEROPTIONS.
+.TP
+.I \-\-remove\-smtp option
+Try to remove the given option from SMTPLISTENEROPTIONS.
+.PP
+The \-\-remove\-commands cannot be used at the same time as any of \-\-commonoptions,
+\-\-queuerunneroptions or \-\-smtplisteneroptions. The \-\-remove\-commands will
+additionally remove whitespace at the beginning and the end of the option and
+exchange multiple spaces wi a single one.
+.TP
+.I \-\-init
+create a default /etc/default/exim4 file and exit immediately. Unless
+.I \-\-force
+was also specified
+.B update\-exim4defaults
+exits (successfully) without doing anything if /etc/default/exim4 already
+exists. All other options are ignored.
+
+.SH EXIT STATUS
+.TP
+.I 0
+change was successful or nothing needed to be done.
+.TP
+.I 1
+generic error: wrong options, unreadable configuration file, etc.
+.TP
+.I 2
+QUEUEINTERVAL was already set.
+.TP
+.I 4
+COMMONOPTIONS was already set.
+.TP
+.I 8
+QUEUERUNNEROPTIONS was already set.
+.TP
+.I 16
+SMTPLISTENEROPTIONS was already set.
+.TP
+.I 32
+QFLAGS was already set.
+.TP
+.I 64
+\-\-remove\-something failed, i.e. the value of the option was not changed.
+.PP
+Exit codes 2 to 32 will be summed up, if more than one unsuccessful option was
+given.
+
+.SH FILES
+.TP
+.I /etc/default/exim4
+The configuration file.
+.TP
+.I /etc/init.d/exim4
+The Exim init\-script.
+.TP
+.I /etc/ppp/ip\-up.d/exim4
+The queuerunner in this file also uses COMMONOPTIONS and QUEUERUNNEROPTIONS and
+does not run if QUEUERUNNER=no.
+
+
+.SH BUGS
+This manual page needs a major re-work. If somebody knows better groff
+than us and has more experience in writing manual pages, any patches
+would be greatly appreciated.
+
+.SH SEE ALSO
+.BR exim (8),
+/usr/share/doc/exim4\-base/
+
+.SH AUTHOR
+Andreas Metzler <ametzler at downhill.at.eu.org>