The Exim Mail Transport Agent
1 Introduction
1.1 Mailing list and Web site
1.2 Availability
1.3 Limitations
1.4 Features
1.5 Support for IPv6
1.6 Interface
1.7 Terminology
2 Incorporated code
3 How Exim delivers mail
3.1 Philosophy
3.2 Message reception
3.3 Life of a message
3.4 Drivers
3.5 Delivery in detail
3.6 Temporary delivery failures
4 Building and installing Exim
4.1 Unpacking
4.2 Multiple machine architectures and operating systems
4.3 DBM libraries
4.4 Pre-building configuration
4.5 Including support for IPv6
4.6 The building process
4.7 Overriding build-time options for Exim
4.8 OS-specific header files
4.9 Overriding build-time options for the monitor
4.10 Installing commands and scripts
4.11 Setting up the spool directory
4.12 Testing
4.13 Switching Exim on
4.14 Stopping Exim on Solaris 2
5 The Exim command line
5.1 Setting options by program name
5.2 Trusted and admin users
5.3 Command line options
--
option
-bd
option
-bF <filename>
option
-bf <filename>
option
-bh <IP address>
option
-bi
option
-bm
option
-bp
option
-bpa
option
-bpu
option
-bP
option
-brt
option
-brw
option
-bS
option
-bs
option
-bt
option
-bV
option
-bv
option
-bvs
option
-C <filename>
option
-D<macro>=<value>
option
-d<number>
option
-df
option
-dm
option
-dropcr
option
-E
option
-ex
option
-F <string>
option
-f <address>
option
-h <number>
option
-i
option
-M
option
-Mar <message id> <address> <address>
option
-MC <transport> <hostname> <sequence number> <message id>
option
-MCS
option
-Mc
option
-Meb <message id>
option
-Mes <message id> <address>
option
-Mf
option
-Mg
option
-Mmad <message id>
option
-Mmd <message id> <address> <address>
option
-Mrm
option
-Mt
option
-m
option
-N
option
-oA <file name>
option
-oB <n>
option
-odb
option
-odf
option
-odi
option
-odq
option
-odqr
option
-odqs
option
-oee
option
-oem
option
-oep
option
-oeq
option
-oew
option
-oi
option
-oMa <host address>
option
-oMr <protocol name>
option
-oMs <host name>
option
-oMt <ident string>
option
-om
option
-or <time>
option
-ov
option
-oX <number>
option
-q
option
-q <time>
option
-qf
option
-qfl
option
-ql
option
-qq
option
-qR <string>
option
-qRf <string>
option
-R <string>
option
-Rf <string>
option
-r
option
-t
option
-v
option
-x
option
6 File and database lookups
6.1 Single-key lookup types
6.2 Query-style lookup types
6.3 Use of data lookups
6.4 Temporary errors in lookups
6.5 Partial matching in lookups
6.6 More about NIS+
6.7 More about LDAP
7 The Exim configuration file
7.1 Configuration file format
7.2 Macros in the configuration file
7.3 Common option syntax
7.4 Integer
7.5 Fixed point number
7.6 Time interval
7.7 String
7.8 Expanded strings
7.9 User and group names
7.10 String lists
7.11 Domain lists
7.12 Partial matching in domain lists
7.13 Address lists
7.14 Host lists
7.15 Net lists
8 Regular expressions
9 String expansions
9.1 Testing string expansions
9.2 Expansion items
9.3 Expansion operators
9.4 Expansion conditions
9.5 Expansion variables
9.6 Expansion string examples
10 Main configuration
accept_8bitmime
option
accept_timeout
option
address_directory_transport
option
address_directory2_transport
option
address_file_transport
option
address_pipe_transport
option
address_reply_transport
option
always_bcc
option
auto_thaw
option
bi_command
option
check_log_inodes
option
check_log_space
option
check_spool_inodes
option
check_spool_space
option
collapse_source_routes
option
daemon_smtp_service
option
debug_level
option
debug_transport
option
delay_warning
option
delay_warning_condition
option
deliver_load_max
option
deliver_queue_load_max
option
delivery_date_remove
option
dns_again_means_nonexist
option
dns_retrans
option
dns_retry
option
envelope_to_remove
option
errmsg_text
option
errmsg_file
option
errors_address
option
errors_copy
option
errors_reply_to
option
exim_group
option
exim_path
option
exim_user
option
finduser_retries
option
forbid_domain_literals
option
freeze_tell_mailmaster
option
gecos_name
option
gecos_pattern
option
headers_check_syntax
option
headers_checks_fail
option
headers_sender_verify
option
headers_sender_verify_errmsg
option
helo_string_syntax
option
helo_verify
option
helo_verify_except_hosts
option
helo_verify_except_nets
option
helo_verify_nets
option
hold_domains
option
hold_domains_except
option
host_lookup_nets
option
ignore_errmsg_errors
option
ignore_errmsg_errors_after
option
keep_malformed
option
kill_ip_options
option
local_domains
option
local_domains_include_host
option
local_domains_include_host_literals
option
local_interfaces
option
locally_caseless
option
log_all_parents
option
log_arguments
option
log_file_path
option
log_ip_options
option
log_level
option
log_received_recipients
option
log_received_sender
option
log_refused_recipients
option
log_rewrite
option
log_smtp_confirmation
option
log_subject
option
message_body_visible
option
message_filter
option
message_filter_directory_transport
option
message_filter_directory2_transport
option
message_filter_file_transport
option
message_filter_group
option
message_filter_pipe_transport
option
message_filter_reply_transport
option
message_filter_user
option
message_id_header_text
option
message_size_limit
option
never_users
option
nobody_group
option
nobody_user
option
percent_hack_domains
option
pid_file_path
option
preserve_message_logs
option
primary_hostname
option
print_topbitchars
option
prod_requires_admin
option
prohibition_message
option
qualify_domain
option
qualify_recipient
option
queue_only
option
queue_only_load
option
queue_remote
option
queue_remote_except
option
queue_run_in_order
option
queue_run_max
option
queue_smtp
option
queue_smtp_except
option
rbl_domains
option
rbl_except_nets
option
rbl_reject_recipients
option
rbl_warn_header
option
received_header_text
option
received_headers_max
option
receiver_try_verify
option
receiver_unqualified_hosts
option
receiver_unqualified_nets
option
receiver_verify
option
receiver_verify_addresses
option
receiver_verify_except_hosts
option
receiver_verify_except_nets
option
receiver_verify_senders
option
receiver_verify_senders_except
option
recipients_max
option
recipients_max_reject
option
recipients_reject_except
option
refuse_ip_options
option
relay_domains
option
relay_domains_include_local_mx
option
relay_match_host_or_sender
option
remote_max_parallel
option
remote_sort
option
retry_interval_max
option
return_path_remove
option
return_size_limit
option
rfc1413_except_hosts
option
rfc1413_except_nets
option
rfc1413_query_timeout
option
security
option
sender_accept
option
sender_accept_recipients
option
sender_address_relay
option
sender_host_accept
option
sender_host_accept_relay
option
sender_host_reject
option
sender_host_reject_except
option
sender_host_reject_recipients
option
sender_host_reject_relay
option
sender_net_accept
option
sender_net_accept_relay
option
sender_net_reject
option
sender_net_reject_except
option
sender_net_reject_recipients
option
sender_net_reject_relay
option
sender_reject
option
sender_reject_except
option
sender_reject_recipients
option
sender_try_verify
option
sender_unqualified_hosts
option
sender_unqualified_nets
option
sender_verify
option
sender_verify_batch
option
sender_verify_except_hosts
option
sender_verify_except_nets
option
sender_verify_fixup
option
sender_verify_log_details
option
sender_verify_reject
option
smtp_accept_max
option
smtp_accept_queue
option
smtp_accept_reserve
option
smtp_banner
option
smtp_connect_backlog
option
smtp_etrn_hosts
option
smtp_etrn_nets
option
smtp_etrn_serialize
option
smtp_expn_hosts
option
smtp_expn_nets
option
smtp_load_reserve
option
smtp_receive_timeout
option
smtp_reserve_hosts
option
smtp_reserve_nets
option
smtp_verify
option
split_spool_directory
option
spool_directory
option
strip_excess_angle_brackets
option
strip_trailing_dot
option
trusted_groups
option
trusted_users
option
unknown_login
option
unknown_username
option
uucp_from_pattern
option
uucp_from_sender
option
warnmsg_file
option
11 Driver specifications
12 Default transports
13 Environment for running local transports
13.1 Uids and gids
13.2 Current and home directories
14 Generic options for transports
driver (transport)
option
headers_add (transport)
option
headers_remove (transport)
option
shadow_condition (transport)
option
shadow_transport (transport)
option
transport_filter (transport)
option
15 The appendfile transport
15.1 Private options for appendfile
allow_symlink (appendfile)
option
batch (appendfile)
option
batch_max (appendfile)
option
bsmtp (appendfile)
option
bsmtp_helo (appendfile)
option
check_group (appendfile)
option
create_directory (appendfile)
option
create_file (appendfile)
option
current_directory (appendfile)
option
delivery_date_add (appendfile)
option
directory (appendfile)
option
directory_mode (appendfile)
option
envelope_to_add (appendfile)
option
file (appendfile)
option
file_must_exist (appendfile)
option
from_hack (appendfile)
option
group (appendfile)
option
lock_interval (appendfile)
option
lock_retries (appendfile)
option
lockfile_mode (appendfile)
option
lockfile_timeout (appendfile)
option
maildir_format (appendfile)
option
maildir_retries (appendfile)
option
mode (appendfile)
option
mode_fail_narrower (appendfile)
option
notify_comsat (appendfile)
option
prefix (appendfile)
option
quota (appendfile)
option
require_lockfile (appendfile)
option
retry_use_local_part (appendfile)
option
return_path_add (appendfile)
option
suffix (appendfile)
option
use_crlf (appendfile)
option
use_fcntl_lock (appendfile)
option
use_lockfile (appendfile)
option
user (appendfile)
option
15.2 Operational details for appending
15.3 Operational details for delivery to a new file
16 The autoreply transport
16.1 Private options for autoreply
bcc (autoreply)
option
cc (autoreply)
option
file (autoreply)
option
file_expand (autoreply)
option
file_optional (autoreply)
option
from (autoreply)
option
group (autoreply)
option
headers (autoreply)
option
initgroups (autoreply)
option
log (autoreply)
option
mode (autoreply)
option
once (autoreply)
option
return_message (autoreply)
option
subject (autoreply)
option
text (autoreply)
option
to (autoreply)
option
user (autoreply)
option
17 The debug transport
18 The pipe transport
18.1 Returned status and data
18.2 How the command is run
18.3 Environment variables
18.4 Private options for pipe
allow_commands (pipe)
option
batch (pipe)
option
batch_max (pipe)
option
bsmtp (pipe)
option
bsmtp_helo (pipe)
option
command (pipe)
option
current_directory (pipe)
option
delivery_date_add (pipe)
option
directory (pipe)
option
envelope_to_add (pipe)
option
freeze_exec_fail (pipe)
option
from_hack (pipe)
option
group (pipe)
option
home_directory (pipe)
option
ignore_status (pipe)
option
initgroups (pipe)
option
log_defer_output (pipe)
option
log_fail_output (pipe)
option
log_output (pipe)
option
max_output (pipe)
option
path (pipe)
option
pipe_as_creator (pipe)
option
prefix (pipe)
option
restrict_to_path (pipe)
option
retry_use_local_part (pipe)
option
return_fail_output (pipe)
option
return_output (pipe)
option
return_path_add (pipe)
option
suffix (pipe)
option
timeout (pipe)
option
umask (pipe)
option
use_crlf (pipe)
option
use_shell (pipe)
option
user (pipe)
option
18.5 Using an external local delivery agent
19 The smtp transport
allow_localhost (smtp)
option
batch_max (smtp)
option
command_timeout (smtp)
option
connect_timeout (smtp)
option
data_timeout (smtp)
option
delay_after_cutoff (smtp)
option
dns_qualify_single (smtp)
option
dns_search_parents (smtp)
option
fallback_hosts (smtp)
option
final_timeout (smtp)
option
gethostbyname (smtp)
option
hosts (smtp)
option
interface (smtp)
option
max_rcpt (smtp)
option
multi_domain (smtp)
option
mx_domains (smtp)
option
non_mx_domains (smtp)
option
serialize_hosts (smtp)
option
serialize_nets (smtp)
option
service (smtp)
option
20 Common generic options for directors and routers
condition (director or router)
option
domains (director or router)
option
driver (director or router)
option
errors_to (director or router)
option
except_domains (director or router)
option
except_local_parts (director or router)
option
except_senders (director or router)
option
fail_verify (director or router)
option
fail_verify_recipient (director or router)
option
fail_verify_sender (director or router)
option
headers_add (director or router)
option
headers_remove (director or router)
option
local_parts (director or router)
option
more (director or router)
option
require_files (director or router)
option
senders (director or router)
option
transport (director or router)
option
unseen (director or router)
option
verify (director or router)
option
verify_only (director or router)
option
verify_recipient (director or router)
option
verify_sender (director or router)
option
21 Additional generic options for directors
expn (director)
option
new_director (director)
option
prefix (director)
option
prefix_optional (director)
option
suffix (director)
option
suffix_optional (director)
option
21.1 Skipping directors
22 The aliasfile director
22.1 Alias file format
22.2 Types of alias item
22.3 Duplicate addresses
22.4 Errors in alias files
22.5 Specifying a transport
22.6 Aliasfile private options
check_ancestor (aliasfile)
option
current_directory (aliasfile)
option
directory (aliasfile)
option
directory_transport (aliasfile)
option
directory2_transport (aliasfile)
option
errors_to (aliasfile)
option
expand (aliasfile)
option
file (aliasfile)
option
file_transport (aliasfile)
option
forbid_file (aliasfile)
option
forbid_pipe (aliasfile)
option
freeze_missing_include (aliasfile)
option
group (aliasfile)
option
home_directory (aliasfile)
option
include_domain (aliasfile)
option
initgroups (aliasfile)
option
modemask (aliasfile)
option
optional (aliasfile)
option
owners (aliasfile)
option
owngroups (aliasfile)
option
pipe_transport (aliasfile)
option
qualify_preserve_domain (aliasfile)
option
queries (aliasfile)
option
query (aliasfile)
option
rewrite (aliasfile)
option
search_type (aliasfile)
option
skip_syntax_errors (aliasfile)
option
syntax_errors_to (aliasfile)
option
user (aliasfile)
option
23 The forwardfile director
23.1 Forward file items
23.2 Errors in forward files
23.3 Filter files
23.4 The home directory
23.5 Forwardfile private options
allow_system_actions (forwardfile)
option
check_ancestor (forwardfile)
option
check_group (forwardfile)
option
check_local_user (forwardfile)
option
current_directory (forwardfile)
option
directory (forwardfile)
option
directory_transport (forwardfile)
option
directory2_transport (forwardfile)
option
errors_to (forwardfile)
option
file (forwardfile)
option
file_directory (forwardfile)
option
file_transport (forwardfile)
option
filter (forwardfile)
option
forbid_file (forwardfile)
option
forbid_filter_log (forwardfile)
option
forbid_filter_logwrite (forwardfile)
option
forbid_include (forwardfile)
option
forbid_pipe (forwardfile)
option
forbid_reply (forwardfile)
option
freeze_missing_include (forwardfile)
option
group (forwardfile)
option
home_directory (forwardfile)
option
ignore_eacces (forwardfile)
option
ignore_enotdir (forwardfile)
option
initgroups (forwardfile)
option
modemask (forwardfile)
option
owners (forwardfile)
option
owngroups (forwardfile)
option
pipe_transport (forwardfile)
option
qualify_preserve_domain (forwardfile)
option
reply_transport (forwardfile)
option
rewrite (forwardfile)
option
seteuid (forwardfile)
option
skip_syntax_errors (forwardfile)
option
syntax_errors_to (forwardfile)
option
user (forwardfile)
option
24 The localuser director
current_directory (localuser)
option
directory (localuser)
option
home_directory (localuser)
option
initgroups (localuser)
option
match_directory (localuser)
option
25 The smartuser director
new_address (smartuser)
option
panic_expansion_fail (smartuser)
option
26 Additional generic options for routers
pass_on_timeout (router)
option
self (router)
option
26.1 Skipping routers
27 The domainlist router
host_find_failed (domainlist)
option
modemask (domainlist)
option
owners (domainlist)
option
owngroups (domainlist)
option
route_file (domainlist)
option
route_list (domainlist)
option
route_queries (domainlist)
option
route_query (domainlist)
option
search_type (domainlist)
option
27.1 Routing rules
27.2 Host list format
27.3 Options format
27.4 Application of routing rules
27.5 Domainlist examples
28 The ipliteral router
29 The iplookup router
hosts (iplookup)
option
optional (iplookup)
option
protocol (iplookup)
option
query (iplookup)
option
reroute (iplookup)
option
response_pattern (iplookup)
option
service (iplookup)
option
timeout (iplookup)
option
30 The lookuphost router
gethostbyname (lookuphost)
option
mx_domains (lookuphost)
option
non_mx_domains (lookuphost)
option
qualify_single (lookuphost)
option
rewrite_headers (lookuphost)
option
search_parents (lookuphost)
option
self_mx (lookuphost)
option
widen_domains (lookuphost)
option
31 The queryprogram router
command (queryprogram)
option
current_directory (queryprogram)
option
group (queryprogram)
option
timeout (queryprogram)
option
user (queryprogram)
option
32 Retry configuration
32.1 Retry rules
32.2 Retry rule examples
32.3 Long-term failures
33 Address rewriting
33.1 Rewriting rules
33.2 Rewriting patterns
33.3 Rewriting replacements
33.4 Rewriting flags
33.5 Rewriting examples
34 Customizing error and warning messages
34.1 Customizing error messages
34.2 Customizing warning messages
35 The default configuration file
35.1 Main configuration settings
35.2 Transport configuration settings
35.3 Director configuration settings
35.4 Router configuration settings
35.5 Default retry rule
35.6 Rewriting configuration
36 Multiple user mailboxes
37 Using Exim to handle mailing lists
37.1 Closed mailing lists
38 Virtual domains
38.1 All mail to a given host
38.2 Virtual domains not preserving envelopes
38.3 Virtual domains preserving envelopes
39 Intermittently connected hosts
40 Verification of incoming mail
40.1 Host verification
40.2 Sender verification
40.3 Fixing bad senders
40.4 Header verification
40.5 Receiver verification
41 Other policy controls on incoming mail
41.1 Host checking using RBL
41.2 Other host checking
41.3 Network checking
41.4 Sender checking
41.5 Control of relaying
41.6 Policy checking flowchart
41.7 Prohibition messages
42 System-wide message filtering
42.1 The system message filter
42.2 Per-address filtering
43 SMTP processing
43.1 Outgoing SMTP over TCP/IP
43.2 Incoming SMTP over TCP/IP
43.3 Outgoing batched SMTP
43.4 Incoming batched SMTP
44 Message processing
44.1 Unqualified addresses
44.2 The Bcc header
44.3 The Date header
44.4 The Delivery-date header
44.5 The Envelope-to header
44.6 The From header
44.7 The Message-id header
44.8 The Received header
44.9 The Return-path header
44.10 The Sender header
44.11 The To header
44.12 Adding and removing headers
44.13 Constructed addresses
44.14 Case of local parts
44.15 Rewriting addresses
45 Automatic mail processing
45.1 System-wide automatic processing
45.2 Taking copies of mail
45.3 Automatic processing by users
45.4 Simplified vacation processing
46 Log files
46.1 Logging message reception
46.2 Logging deliveries
46.3 Deferred deliveries
46.4 Delivery failures
46.5 Completion
46.6 Log level
46.7 Message log
47 Day-to-day management
47.1 The panic log
47.2 The reject log
47.3 Log cycling
47.4 Statistics
47.5 What is Exim doing?
47.6 Changing the configuration
47.7 Watching the queue
47.8 Holding domains
48 Exim utilities
48.1 Querying Exim processes
48.2 Summarising the queue
48.3 Extracting log information
48.4 Cycling log files
48.5 Making DBM files
48.6 Individual retry times
48.7 Database maintenance
48.8 Mail statistics
-nt
option
-h<n>
option
-q0
option
-q<n1>
option
-nr
option
-nr/pattern/
option
-t<n>
option
-tnl
option
-ne
option
49 The Exim monitor
49.1 Running the monitor
49.2 The stripcharts
49.3 Main action buttons
49.4 The log display
49.5 The queue display
49.6 The queue menu
50 Security considerations
50.1 Root privilege
50.2 Reading forward files
50.3 Delivering to local files
50.4 IPv4 source routing
50.5 The VRFY, EXPN, and ETRN commands in SMTP
50.6 Privileged users
50.7 Spool files
50.8 Use of argv[0]
50.9 Use of %f formatting
50.10 Embedded Exim path
50.11 Use of sprintf()
50.12 Use of debug_printf() and log_write()
50.13 Use of strcat() and strcpy()
51 Format of spool files
52 Adding new drivers or lookup types
53 Concept Index
54 Function Index
This document was generated on 2 April 1998 using the
texi2html
translator version 1.52.