diff options
Diffstat (limited to 'debian/manpages')
| -rw-r--r-- | debian/manpages/exicyclog.8 | 75 | ||||
| -rw-r--r-- | debian/manpages/exigrep.8 | 70 | ||||
| -rw-r--r-- | debian/manpages/exim4-config_files.5 | 364 | ||||
| -rw-r--r-- | debian/manpages/exim_checkaccess.8 | 80 | ||||
| -rw-r--r-- | debian/manpages/exim_convert4r4.8 | 73 | ||||
| -rw-r--r-- | debian/manpages/exim_db.8 | 193 | ||||
| -rw-r--r-- | debian/manpages/exim_dbmbuild.8 | 105 | ||||
| -rw-r--r-- | debian/manpages/exim_lock.8 | 153 | ||||
| -rw-r--r-- | debian/manpages/eximon.8 | 50 | ||||
| -rw-r--r-- | debian/manpages/exinext.8 | 73 | ||||
| -rw-r--r-- | debian/manpages/exiqgrep.8 | 88 | ||||
| -rw-r--r-- | debian/manpages/exiqsumm.8 | 74 | ||||
| -rw-r--r-- | debian/manpages/exiwhat.8 | 102 | ||||
| -rw-r--r-- | debian/manpages/update-exim4.conf.8 | 346 | ||||
| -rw-r--r-- | debian/manpages/update-exim4.conf.template.8 | 92 | ||||
| -rw-r--r-- | debian/manpages/update-exim4defaults.8 | 173 |
16 files changed, 2111 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..3d8833b --- /dev/null +++ b/debian/manpages/exim_lock.8 @@ -0,0 +1,153 @@ +.\" 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 "May 12, 2020" +.\" 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 "appendfile transport", +subsection "Operational details for appending" the Exim specification. +.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 \-flock +Use \(lqflock()\(rq locking on the open mailbox, provided the operating +system supports it. +.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 \-restore_time +This option causes exim_lock to restore the modified and read times to the +locked file before exiting. This allows you to access a locked mailbox (for +example, to take a backup copy) without disturbing the times that the user +subsequently sees. +.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, \-flock, \-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 +or +.I \-flock +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 +can be used with either or both of +.I \-fcntl +or +.I \-flock. +It assumes +.I \-fcntl +by default. MBX locking 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> |