qmail-remote(8)       Maintenance Procedures      qmail-remote(8)



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  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.  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, 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.




SunOS 5.5                 Last change:                          1






qmail-remote(8)       Maintenance Procedures      qmail-remote(8)



     K    Message report: success.  host has taken responsibility
          for delivering the message to each  acceptable  recipi-
          ent.

     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 fail-
     ure 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 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



SunOS 5.5                 Last change:                          2






qmail-remote(8)       Maintenance Procedures      qmail-remote(8)



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













































SunOS 5.5                 Last change:                          3