smtpfeed - SMTP Fast Exploding External Deliverer
smtpfeed [-1] [-5] [-A] [-a alias] [-b bufsize] [-c name] [-d debugopt]
[-E] [-F] [-F -F] [-g pgateway] [-h] [-i queue-id] [-I queue-id] [-l
facility] [-M mapfile] [-m fallback-mx] [-N domain] [-n num] [-o
source-addr] [-p source-port] [-q num] [-r num] [-R num] [-S pattern]
[-s size] [-t category=value] [-u] [-V] [-x] [-y] [-z]
This manual page documents the smtpfeed command, an LMTP-speaking mail
delivery agent (MDA) dedicated to mass mail delivery, i.e., the
delivery of mails via SMTP, addressed to large number of recipients.
So smtpfeed is effective for delivery of large mailing lists. smtpfeed
is spawned by a mail transfer agent (MTA) like Sendmail or Postfix,
receives the mail and recipients via LMTP on stdin/stdout and performs
SMTP delivery by first processing DNS queries in parallel, followed by
parallel processing of SMTP deliveries. smtpfeed can not deliver huge
messages because it stores all information (includes message data) in
A description of the available command options are included below.
-1 Disable SMTP piggybacking (equivalent to -R1).
-5 If smtpfeed works only with IPv4 (IPv6) protocol (see option
-N), and if peer host has only AAAA (A) RRs in DNS, message will
not be bounced back with "Host not found" error, and fallback MX
(option -m) will be used.
-A Try T_ANY DNS query first to get MX list.
Specify this host’s alias name, which is used to check MX list.
Specify TCP send buffer size.
Specify official full-qualified domain name (FQDN) of this host,
which is used in SMTP HELO command.
Specify debug options. Possible values for debugopt are one or
more of the following: A: all, a: address, c: connection, e:
event, h: hash, l: LMTP, m: map, n: DNS, s: SMTP, t:
transaction, u: resource usage, D: no delivery, Q: DNS query
-E Get queue-id information from Received: header.
-F Insert recipient information on Received: header line if number
of recipients for an SMTP transaction is only one (see also
-F -F Modify envelope sender address like
"SenderUser+RcptUser=RcptDomain@SenderDomain" when -1 option is
specified. If you want to use this feature, configure your mail
server to receive such addresses. Note: this modification will
not be done when envelope sender is "<>". See also option -S.
Protocol gateway host (Default: not defined). Option -5 must be
specified at the same time. Option -N4 or -N6 must also be
specified at the same time if compiled with -DINET6. If -N4 is
specified (or compiled without -DINET6), if an MX has IPv6
addresses, pgateway will be used as first MX. This feature will
be useful when delivery via pgateway with fat IPv6 network is
faster than direct delivery with narrow IPv4 network. If -N6 is
specified, pgateway will be used if an MX has IPv4 addresses,
-h Show help message.
The queue-id as generated by the MTA - just for logging
purposes. (macro name for queue-id in sendmail.cf is $i.)
Equivalent to option -i, but no purge on SMTP RSET command.
Specify syslog(3) logging facility (default is "local5").
Path of host map file (Default: not defined). Syntax of map
file is: "DOMAIN DEST1:DEST2:... # comments" where DOMAIN can be
"domain" (exact matching) or ".domain" (substring matching) and
DEST can be "hostname" (MX for hostname), "[hostname]" (A for
hostname), "[IPaddress]" (IP address), "MX" (MX for domain part
of a mail address), "MX?" (same as MX (skip to following dest.
even under DNS lookup failure), "A" (A for domain part of a mail
address), "=alias" (MX for an aliased mail address).
Fallback MX host.
Specify network domain. Possible .I domain specifiers are: 4:
use IPv4 only, 6: use IPv6 only, B: use both of IPv4/IPv6 at
random, B4: IPv4 then IPv6, B6: IPv6 then IPv4.
-n num Specify maximum number of available sockets for use. (Default:
Source TCP/IP address for outgoing SMTP connections. (Default:
an appropriate address will be dynamically assigned.)
Source TCP/IP port for outgoing SMTP connections. (Default: a
free port will be dynamically assigned.)
-q num Maximum DNS query concurrency. (Default: 50)
-R num Specify maximum number of recipients in a single SMTP
transaction. (Default: 100)
-r num Specify minimum number of recipients required for an SMTP
transaction. (Default: 1)
Format to be used at envelope sender address conversion when -F
-F option specified. (Default: <%s+%s=%s@%s>)
Specify maximum message size. (Default: unlimited)
Set communication timeouts. Numbers followed by ’s’ means ’in
seconds’, by ’m’ means
’in minutes’ and by ’h’ means ’in hours’. default is ’m’.
Values for category are: "total" (total processing limit (55m),
it will be take "total + quit"), "connect" (till TCP connection
establishment (5m)), "greet" (till get SMTP greeting message
(5m)), "helo" (till get response for HELO (5m)), "mail" (till
get response for MAIL (10m)), "rcpt" (till get response for RCPT
(60m)), "data" (till get response for DATA (5m)), "body" (till
send next datablock (20m)), "term" (till get response for DATA
termination (60m)), "cache" (for idle SMTP connection (5m)),
"rset" (till get response for RSET (5m)), "quit" (till get
response for QUIT (2m)).
-u Reuse SMTP connection for other MX. (default: off)
-V Force to insert version number in Received: line.
-x No error even if MX RRs point to absent A/AAAA RRs.
-y Refer to DNS A RR if this host is the first MX.
-z Disable SMTP pipelining.
This manual page was written by Ralf S. Engelschall
<email@example.com> for the OpenPKG smtpfeed package.