Provided by: smtpfeed_1.19-2_i386 bug

NAME

       smtpfeed - SMTP Fast Exploding External Deliverer

SYNOPSIS

       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]

DESCRIPTION

       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
       memory.

OPTIONS

       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.

       -a alias
              Specify  this host’s alias name, which is used to check MX list.

       -b bufsize
              Specify TCP send buffer size.

       -c name
              Specify official full-qualified domain name (FQDN) of this host,
              which is used in SMTP HELO command.

       -d debugopt
              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
              only.

       -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
              option -1).

       -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.

       -g pgateway
              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,
              conversely.

       -h     Show help message.

       -i queue-id
              The  queue-id  as  generated  by  the  MTA  -  just  for logging
              purposes.  (macro name for queue-id in sendmail.cf is $i.)

       -I queue-id
              Equivalent to option -i, but no purge on SMTP RSET command.

       -l facility
              Specify syslog(3) logging facility (default is "local5").

       -M mapfile
              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).

       -m fallback-mx
              Fallback MX host.

       -N domain
              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:
              FD_SETSIZE-1).

       -o source-addr
              Source TCP/IP address for outgoing SMTP connections.   (Default:
              an appropriate address will be dynamically assigned.)

       -p source-port
              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)

       -S pattern
              Format to be used at envelope sender address conversion when  -F
              -F option specified. (Default: <%s+%s=%s@%s>)

       -s size
              Specify maximum message size.  (Default: unlimited)

       -t category=value
              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.

AUTHOR

       This   manual   page   was   written    by    Ralf    S.    Engelschall
       <rse@engelschall.com> for the OpenPKG smtpfeed package.