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.

       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),   qmail-
       tcpok(8), qmail-tcpto(8)

                                                                                  qmail-remote(8)