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 de-
       bugopt] [-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  pat-
       tern] [-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	deliv-
       ery  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,  re-
       ceives  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 do-
	      main).

       -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: transac-
	      tion, 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 op-
	      tion -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 ad-
	      dresses.	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 spec-
	      ified at the same	time if	compiled with -DINET6. If -N4 is spec-
	      ified  (or  compiled  without  -DINET6),	if  an MX has IPv6 ad-
	      dresses, 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 pur-
	      poses.  (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  transac-
	      tion.  (Default: 100)

       -r num Specify minimum number of	recipients required for	an SMTP	trans-
	      action.  (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'.  Val-
	      ues  for category	are: "total" (total processing limit (55m), it
	      will be take "total + quit"), "connect" (till TCP	connection es-
	      tablishment (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 re-
	      sponse 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@en-
       gelschall.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.0>

home | help