The keywords following the channel name are used to assign various attributes to the channel. Keywords are case insensitive, and may be up to 32 characters long; any additional characters are ignored. The supported keywords are listed in TABLE 3-8; the keywords shown in boldface type are defaults.
Keyword
|
Usage
|
|---|
|
addrsperfile
|
Number of addresses per message file
|
|
addrsperjob
|
Number of addresses to be processed by a single job
|
|
after
|
Specify time delay before master channel programs run
|
|
allowswitchchannel
|
Allow switching to this channel from a allowswitchchannel channel
|
|
bangoverpercent
|
Group A!B%C as A!(B%C)
|
|
bidirectional
|
Channel is served by both a master and slave program
|
|
blocklimit
|
Maximum number of IMTA blocks allowed per message
|
|
cacheeverything
|
Cache all connection information
|
|
cachefailures
|
Cache only connection failure information
|
|
cachesuccess
|
Cache only connection success information
|
|
charset7
|
Default character set to associate with 7-bit text messages
|
|
charset8
|
Default character set to associate with 8-bit text messages
|
|
checkehlo
|
Check the SMTP response banner for whether to use EHLO
|
|
commentinc
|
Leave comments in message header lines intact
|
|
commentomit
|
Remove comments from message header lines
|
|
commentstrip
|
Remove problematic characters from comment field in message header lines
|
|
commenttotal
|
Strip comments (material in parentheses) everywhere
|
|
connectalias
|
Do not rewrite addresses upon message dequeue
|
|
connectcanonical
|
Rewrite addresses upon message dequeue
|
|
contchar
|
Specify batch SMTP continuation line character
|
|
contposition
|
Specify folding point in batch SMTP lines
|
|
convert_octet_stream
|
Convert application or octet-stream material as appropriate
|
|
copysendpost
|
Send copies of failures to the postmaster unless the originator address is blank
|
|
copywarnpost
|
Send copies of warnings to the postmaster unless the originator address is blank
|
|
daemon
|
Specify the name of a gateway to which the daemon is routed
|
|
datefour
|
Convert date/time specifications to four-digit years
|
|
datetwo
|
Convert date/time specifications to two-digit years
|
|
dayofweek
|
Include day of week in date and time specifications
|
|
defaultmx
|
Channel determines whether or not to do MX lookups from network
|
|
deferred
|
Honor deferred delivery dates
|
|
defragment
|
Reassemble any MIME-compliant message/partial parts queued to this channel (Enterprise Edition only)
|
|
domainvrfy
|
Issue SMTP VRFY commands using full address
|
|
ehlo
|
Use EHLO on all initial SMTP connections
|
|
eightbit
|
Channel supports eight-bit characters
|
|
eightnegotiate
|
Channel should negotiate use of eight bit transmission, if possible
|
|
eightstrict
|
Channel should reject messages that contain unnegotiated eight-bit data
|
|
errsendpost
|
Send copies of failures to the postmaster if the originator address is illegal
|
|
errwarnpost
|
Send copies of warnings to the postmaster if the originator address is illegal
|
|
expandlimit
|
Process an incoming message "offline" when the number of addressees exceeds this limit
|
|
exproute
|
Explicit routing for this channel's addresses
|
|
filesperjob
|
Number of queue entries to be processed by a single job
|
|
headerinc
|
Place the message header at the top of the message
|
|
headerlabelalign
|
Align headers
|
|
headerlinelength
|
Fold long headers
|
|
headerread
|
Apply header trimming rules from an options file to the message headers upon message enqueue (use with caution)
|
|
headertrim
|
Apply header trimming rules from an options file to the message headers (use with caution)
|
|
holdexquota
|
Hold extra messages for users who have exceeded their message quota
|
|
identnone
|
Do not perform IDENT lookups; do perform IP-to-hostname translation
|
|
identnonenumeric
|
Do not perform IDENT lookups or IP-to-hostname translation
|
|
identtcp
|
Perform IDENT lookups on incoming SMTP connections and IP to hostname translation
|
|
identtcpnumeric
|
Perform IDENT lookups on incoming SMTP connections, but do not perform IP to hostname translation
|
|
ignoreencoding
|
Ignore Encoding: header on incoming messages
|
|
immediate
|
Delivery started immediately after submission for messages of second-class or higher priority
|
|
immnonurgent
|
Delivery started immediately after submission, even for messages with lower-than-normal priority
|
|
immnormal
|
Delivery started immediately after submission for messages of normal-or-higher priority
|
|
immurgent
|
Delivery started immediately after submission for urgent messages only
|
|
improute
|
Implicit routing for this channel's addresses
|
|
inner
|
Rewrite inner message headers
|
|
innertrim
|
Apply header trimming rules from an options file to inner message headers (use with caution)
|
|
interpretencoding
|
Interpret Encoding: header on incoming messages
|
|
lastresort
|
Specify a last-resort host
|
|
linelength
|
Message lines exceeding this length limit are wrapped
|
|
linelimit
|
Maximum number of lines allowed per message
|
|
localvrfy
|
Issue SMTP VRFY command using local address
|
|
logging
|
Log message enqueues and dequeues into the log file
|
|
master
|
Channel is served only by a master program
|
|
master_debug
|
Generate debugging output in the channel's master program output
|
|
maxblocks
|
Maximum number of IMTA blocks per message; longer messages are broken into multiple messages
|
|
maxheaderaddrs
|
Maximum number of addresses per message header line; longer header lines are broken into multiple header lines
|
|
maxheaderchars
|
Maximum number of characters per message header line; longer header lines are broken into multiple header lines
|
|
maxjobs
|
Maximum number of jobs that can be created at one time
|
|
maxlines
|
Maximum number of message lines per message; longer messages are broken into multiple messages
|
|
maxprocchars
|
Specify maximum length of headers to process
|
|
multiple
|
Accepts multiple destination hosts in a single message copy
|
|
mx
|
TCP/IP network and software supports MX record lookups
|
|
nobangoverpercent
|
Group A!B%C as (A!B)%C (default)
|
|
nocache
|
Do not cache any connection information
|
|
noconvert_octet_stream
|
Do not convert application/octet-stream material
|
|
nodayofweek
|
Remove day of week from date/time specifications
|
|
nodeferred
|
Do not honor deferred delivery dates
|
|
nodefragment
|
Do not perform special processing for message/partial messages
|
|
noehlo
|
Never use the SMTP EHLO command
|
|
noexproute
|
No explicit routing for this channel's addresses
|
|
noexquota
|
Return to originator any messages to users who are over quota
|
|
noheaderread
|
Do not apply header trimming rules from option file upon message enqueue
|
|
noheadertrim
|
Do not apply header trimming rules from options file
|
|
noimproute
|
No implicit routing for this channel's addresses
|
|
noinner
|
Do not rewrite inner message headers
|
|
noinnertrim
|
Do not apply header trimming to inner message headers
|
|
nologging
|
Do not log message enqueues and dequeues into the log file
|
|
nomaster_debug
|
Do not generate debugging output in the channel's master program output
|
|
nomx
|
TCP/IP network does not support MX lookups
|
|
nonrandommx
|
Do MX lookups; do not randomize returned entries with equal precedence
|
|
nonurgentblocklimit
|
Force messages above this size to wait unconditionally for a periodic job
|
|
noreceivedfor
|
Do not include envelope to address in Received: header
|
|
noremotehost
|
Use local host's domain name as the default domain name to complete addresses
|
|
norestricted
|
Do not apply RFC 1137 restricted encoding to addresses
|
|
noreverse
|
Do not apply reverse database to addresses
|
|
normalblocklimit
|
Force messages above this size to nonurgent priority
|
|
nosendpost
|
Do not send copies of failures to the postmaster
|
|
noslave_debug
|
Do not generate debugging output in the channel's slave program output
|
|
nosmtp
|
Channel does not use SMTP
|
|
noswitchchannel
|
Stay with the server channel; do not switch to the channel associated with the originating host; do not permit being switched to
|
|
notices
|
Specify the amount of time that may elapse before notices are sent and messages returned
|
|
novrfy
|
Do not issue SMTP VRFY commands
|
|
nowarnpost
|
Do not send copies of warnings to the postmaster
|
|
nox_env_to
|
Do not add X-Envelope-to: header lines while enqueuing
|
|
percents
|
Use % routing in the envelope; synonymous with 733
|
|
period
|
Specify periodicity of periodic channel service
|
|
periodic
|
Channel is serviced only periodically; immediate delivery processing is never done
|
|
personalinc
|
Leave personal names in message header lines intact
|
|
personalomit
|
Remove personal name fields from message header lines
|
|
personalstrip
|
Strip problematic characters from personal name fields in message header lines
|
|
port
|
Send to the specified TCP/IP port
|
|
postheadbody
|
Both the message's header and body are sent to the postmaster when a delivery failure occurs
|
|
postheadonly
|
Only the message's header is sent to the postmaster when a delivery failure occurs
|
|
queue
|
Specify queue master channel programs run in
|
|
randommx
|
Do MX lookups; randomize returned entries with equal precedence
|
|
receivedfor
|
Include envelope to address in Received: header
|
|
remotehost
|
Use remote host's name as the default domain name to complete addresses
|
|
restricted
|
Apply RFC 1137 restricted encoding to addresses
|
|
returnenvelope
|
Control use of blank envelope return addresses
|
|
reverse
|
Apply reverse database to addresses
|
|
sendpost
|
Send copies of failures to the postmaster
|
|
sevenbit
|
Channel does not support eight-bit characters; eight-bit characters must be encoded
|
|
single
|
Only one envelope To: address per message copy
|
|
single_sys
|
Each message copy must be for a single destination system
|
|
slave
|
Channel is serviced only by a slave program
|
|
slave_debug
|
Generate debugging output in the channel's slave program output
|
|
smtp
|
Channel uses SMTP
|
|
smtp_cr
|
Accept CR as an SMTP line terminator
|
|
smtp_crlf
|
Require CRLF as the SMTP line terminator
|
|
smtp_lf
|
Accept LF as an SMTP line terminator
|
|
sourceroute
|
Use source routes in the message: envelope; synonymous with 822
|
|
subdirs
|
Use multiple subdirectories
|
|
switchchannel
|
Switch from the server channel to the channel associated with the originating host
|
|
threaddepth
|
Number of messages triggering new thread with multithreaded SMTP client
|
|
unrestricted
|
Do not apply RFC 1137 restricted encoding to addresses
|
|
urgentblocklimit
|
Force messages above this size to normal priority
|
|
user
|
Use local usernames as user tags when possible
|
|
usereplyto
|
Specify mapping of Reply-to: header
|
|
useresent
|
Specify mapping of Resent- headers for non-RFC 822 environments
|
|
warnpost
|
Send copies of warnings to the postmaster
|
|
x_env_to
|
Add X-Envelope-to: header lines while enqueuing
|
Specifying a keyword not on this list is not an error (although it may be incorrect). On UNIX systems, undefined keywords are interpreted as group ids. The imta test -rewrite utility tells you if you have any keywords in your configuration file that don't match a known rights list identifier.