qmail-remote - send mail via SMTP
SYNOPSIS
qmail-remote host sender recip [ recip ... ]
DESCRIPTION
qmail-remote reads a mail message from its input and sends
the message to one or more recipients at a remote host.
The remote host is qmail-remote's first argument, host.
qmail-remote sends the message to host, or to a mail
exchanger for host listed in the Domain Name System, via
the Simple Mail Transfer Protocol (SMTP). host can be
either a fully-qualified domain name:
silverton.berkeley.edu
or an IP address enclosed in brackets:
[128.32.183.163]
The envelope recipient addresses are listed as recip argu-
ments to qmail-remote. The envelope sender address is
listed as sender.
Note that qmail-remote does not take options and does not
follow the getopt standard.
TRANSPARENCY
End-of-file in SMTP is encoded as dot CR LF. A dot at the
beginning of a line is encoded as dot dot. qmail-remote
converts the UNIX newline convention into the SMTP newline
convention by inserting CR before each LF. It is impossi-
ble in SMTP to send a message that does not end with a
newline; qmail-remote will add a final CR LF if necessary.
It is a violation of the SMTP protocol to send a message
that contains long lines or non-ASCII characters. How-
ever, qmail-remote will happily send such messages. It is
the user's responsibility to avoid generating illegal mes-
sages.
RESULTS
qmail-remote prints some number of recipient reports, fol-
lowed by a message report. Each report is terminated by a
0 byte. Each report begins with a single letter:
r Recipient report: acceptance.
h Recipient report: permanent rejection.
s Recipient report: temporary rejection.
ity for delivering the message to each acceptable
recipient.
Z Message report: temporary failure.
D Message report: permanent failure.
After this letter comes a human-readable description of
what happened.
The recipient reports will always be printed in the same
order as qmail-remote's recip arguments. Note that in
failure cases there may be fewer recipient reports than
recip arguments.
qmail-remote always exits zero.
CONTROL FILES
helohost
Current host name, for use solely in saying hello to
the remote SMTP server. Default: me, if that is sup-
plied; otherwise qmail-remote refuses to run.
smtproutes
Artificial SMTP routes. Each route has the form
domain:relay, without any extra spaces. If domain
matches host, qmail-remote will connect to relay, as
if host had relay as its only MX. (It will also
avoid doing any CNAME lookups on sender and recip.)
host may include a colon and a port number to use
instead of the normal SMTP port, 25:
inside.af.mil:firewall.af.mil:26
relay may be empty; this tells qmail-remote to look
up MX records as usual. smtproutes may include wild-
cards:
.af.mil:
:heaven.af.mil
Here any address ending with .af.mil (but not af.mil
itself) is routed by its MX records; any other
address is artificially routed to heaven.af.mil.
The qmail system does not protect you if you create
an artificial mail loop between machines. However,
you are always safe using smtproutes if you do not
accept mail from the network.
timeoutconnect
Number of seconds qmail-remote will wait for the
limit.
timeoutremote
Number of seconds qmail-remote will wait for each
response from the remote SMTP server. Default: 1200.
SEE ALSO
addresses(5), envelopes(5), qmail-control(5),
qmail-send(8), qmail-smtpd(8)