Ubuntu Manpage: qmail-remote - send mail via SMTP

NAME

       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  arguments  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.  It is impossible in SMTP to send a message that does not end with a  newline.
       qmail-remote  converts  the  UNIX  newline  convention into the SMTP newline convention by
       inserting CR before each LF.

       It is a violation of the SMTP protocol to send a message that contains long lines or  non-
       ASCII  characters.   However,  qmail-remote  will  happily  send such messages.  It is the
       user's responsibility to avoid generating illegal messages.

RESULTS

       qmail-remote prints some number of recipient reports, followed 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.

       K    Message report: success.  host has taken responsibility 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 supplied; 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 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 wildcards:

.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 remote SMTP server to accept a
connection. Default: 60. The kernel normally imposes a 75-second upper limit.