Provided by: qmail_1.06-4_i386 bug

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)