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

FreeBSD Manual Pages


home | help
EMAILRELAY(1)		    General Commands Manual		 EMAILRELAY(1)

       emailrelay - e-mail transfer agent and proxy

       emailrelay [OPTIONS]

       emailrelay --as-server

       emailrelay --as-client server-address

       emailrelay --as-proxy server-address

       emailrelay  is a	simple SMTP proxy and store-and-forward	message	trans-
       fer agent.  It does store-and-forward mail relay	to  a  fixed  next-hop
       server, without any routing.

       It  runs	 in  two main modes: a storage daemon (--as-server) and	a for-
       warding agent (--as-client).  The storage  daemon  is  an  SMTP	server
       which stores e-mail messages in a local spool directory.	The forwarding
       agent acts as an	SMTP client sending the	spooled	e-mail messages	on  to
       the next	SMTP server in the chain.

       It  can	also  run in a third mode, as a	proxy server (--as-proxy).  In
       this mode all  messages	are  forwarded	immediately  to	 the  next-hop
       server. Messages	are only fully accepted	from the sender	once they have
       been successfully delivered to the next-hop server.

       -a, --admin _admin-port_
	      Enables the administration interface and specifies its listening
	      port number.

       -Q, --admin-terminate
	      Enables the terminate command on the admin interface.

       -A, --anonymous
	      Disables	the  smtp vrfy command and sends less verbose smtp re-

       -q, --as-client _host:port_
	      Runs as a	client,	forwarding all spooled mail to <host>: equiva-
	      lent  to	--log  --no-syslog  --no-daemon	--dont-serve --forward

       -y, --as-proxy _host:port_
	      Runs as a	proxy server,  forwarding  each	 mail  immediately  to
	      <host>:  equivalent  to --log --close-stderr --poll=0 --forward-

       -d, --as-server
	      Runs as a	server,	storing	mail in	the spool  directory:  equiva-
	      lent to --log --close-stderr.

       -C, --client-auth _file_
	      Enables  smtp  authentication  with the remote server, using the
	      given secrets file.

       -Y, --client-filter _program_
	      Specifies	an external program to process messages	when they  are

       -j, --client-tls
	      Enables  negotiated  tls/ssl  for	 smtp client (if openssl built

       -b, --client-tls-connection
	      Enables smtp over	tls/ssl	for smtp client	(if openssl built in).

       -e, --close-stderr
	      Closes the standard error	stream soon after start-up.

       -U, --connection-timeout	_time_
	      Sets the timeout (in seconds) when connecting to a remote	server
	      (default is 40).

       -g, --debug
	      Generates	debug-level logging if built in.

       -D, --domain _fqdn_
	      Sets an override for the host's fully qualified domain name.

       -x, --dont-serve
	      Disables acting as a server on any port (part of --as-client and
	      usually used with	--forward).

       -z, --filter _program_
	      Specifies	an external program to process messages	 as  they  are

       -W, --filter-timeout _time_
	      Sets the timeout (in seconds) for	running	the --filter processor
	      (default is 300).

       -f, --forward
	      Forwards stored mail on startup (requires	--forward-to).

       -o, --forward-to	_host:port_
	      Specifies	the remote smtp	server (required by --forward, --poll,
	      --immediate and --admin).

       -h, --help
	      Displays help text and exits.

       -m, --immediate
	      Enables immediate	forwarding of messages as soon as they are re-
	      ceived (requires --forward-to).

       -I, --interface _ip-list_
	      Defines the  listening  interface(s)  for	 incoming  connections
	      (comma-separated	list  with  optional  smtp=,pop=,admin=	quali-

       -l, --log
	      Writes log information on	standard error	and  syslog  (but  see
	      --close-stderr and --no-syslog).

       -L, --log-time
	      Adds a timestamp to the logging output.

       -t, --no-daemon
	      Does not detach from the terminal.

       -X, --no-smtp
	      Disables listening for smtp connections (usually used with --ad-
	      min or --pop).

       -n, --no-syslog
	      Disables syslog output (always overridden	by --syslog).

       -i, --pid-file _pid-file_
	      Defines a	file for storing the daemon process-id.

       -O, --poll _period_
	      Enables polling of the spool directory for messages to  be  for-
	      warded  with  the	specified period (zero means on	client discon-
	      nection) (requires --forward-to).

       -B, --pop
	      Enables the pop server.

       -F, --pop-auth _file_
	      Defines the pop server secrets file  (default  is	 /etc/emailre-

       -J, --pop-by-name
	      Modifies	the pop	spool directory	according to the pop user name
	      (requires	--pop).

       -G, --pop-no-delete
	      Disables message deletion	via pop	(requires --pop).

       -E, --pop-port _port_
	      Specifies	the pop	listening port number (default	is  110)  (re-
	      quires --pop).

       -p, --port _port_
	      Specifies	the smtp listening port	number (default	is 25).

       -w, --prompt-timeout _time_
	      Sets the timeout (in seconds) for	getting	an initial prompt from
	      the server (default is 20).

       -r, --remote-clients
	      Allows remote clients to connect.

       -T, --response-timeout _time_
	      Sets the response	timeout	(in seconds) when talking to a	remote
	      server (default is 1800).

       -S, --server-auth _file_
	      Enables  authentication  of  remote clients, using the given se-
	      crets file.

       -K, --server-tls	_pem-file_
	      Enables negotiated tls/ssl  for  smtp  server  using  the	 given
	      openssl certificate file (which must be in the directory trusted
	      by openssl).

       -M, --size _bytes_
	      Limits the size of submitted messages.

       -s, --spool-dir _dir_
	      Specifies	the spool directory  (default  is  /var/spool/emailre-

       -k, --syslog
	      Forces  syslog output if logging is enabled (overrides --no-sys-

       -0, --tls-config	_flags_
	      Sets tls configuration flags (eg.	2 for SSLv2 support).

       -u, --user _username_
	      Names the	effective user to switch to if started	as  root  (de-
	      fault is daemon).

       -v, --verbose
	      Generates	more verbose output (works with	--help and --log).

       -Z, --verifier _program_
	      Specifies	an external program for	address	verification.

       -V, --version
	      Displays version information and exits.

       GNU style...

       FHS style...

       E-MailRelay    user    guide,
       guide.html .
       E-MailRelay reference,
       emailrelay-submit(1), emailrelay-passwd(1),

       Graeme Walker,

				     local			 EMAILRELAY(1)


Want to link to this manual page? Use this URL:

home | help