Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SMTPFEED(8)			  User Manuals			     SMTPFEED(8)

NAME
     smtpfeed - SMTP Fast Exploding External Deliverer

SYNOPSIS
     smtpfeed  [-1]  [-2]  [-5] [-A] [-a alias] [-b bufsize] [-c name] [-d debu-
     gopt] [-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 de-
     livery 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).

     -2     Disable piggybacking among domains (separated delivery per domain).

     -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 nameSpecify  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=RcptDo-
	    main@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), "[IPad-
	    dress]"  (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 transac-
	    tion.  (Default: 1)

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

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

     -t category=value
	    Set  communication timeouts.  Numbers followed by 's' means 'in sec-
	    onds', 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.

Unix				  January 2002			     SMTPFEED(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=smtpfeed&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help