Maintenance Procedures                            qmail-remote(8)



NNNNAAAAMMMMEEEE
     qmail-remote - send mail via SMTP

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee _h_o_s_t _s_e_n_d_e_r _r_e_c_i_p [ _r_e_c_i_p ... ]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee reads a mail message from its input  and  sends
     the message to one or more recipients at a remote host.

     The remote host  is  qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee's  first  argument,  _h_o_s_t.
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee  sends  the  message  to  _h_o_s_t,  or  to  a mail
     exchanger for _h_o_s_t listed in the Domain Name System, via the
     Simple  Mail Transfer Protocol (SMTP).  _h_o_s_t 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  _r_e_c_i_p  argu-
     ments  to  qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee.   The  envelope  sender  address is
     listed as _s_e_n_d_e_r.

     Note that qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee does not take options  and  does  not
     follow the ggggeeeettttoooopppptttt standard.

TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNCCCCYYYY
     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.
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee  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,
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee will happily send such  messages.   It  is  the
     user's responsibility to avoid generating illegal messages.

RRRREEEESSSSUUUULLLLTTTTSSSS
     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee prints some number of _r_e_c_i_p_i_e_n_t  _r_e_p_o_r_t_s,  fol-
     lowed  by a _m_e_s_s_a_g_e _r_e_p_o_r_t. 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.11                Last change:                          1






Maintenance Procedures                            qmail-remote(8)



     K    Message report: success.  _h_o_s_t has taken responsibility
          for  delivering  the  message  to each acceptable reci-
          pient.

     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  qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee's  _r_e_c_i_p  arguments.   Note  that in
     failure cases there may  be  fewer  recipient  reports  than
     _r_e_c_i_p arguments.

     qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee always exits zero.

CCCCOOOONNNNTTTTRRRROOOOLLLL FFFFIIIILLLLEEEESSSS
     _c_l_i_e_n_t_c_e_r_t._p_e_m
          SSL certificate that is used to authenticate  with  the
          remote server during a TLS session.

     _h_e_l_o_h_o_s_t
          Current host name, for use solely in  saying  hello  to
          the  remote SMTP server.  Default:  _m_e, if that is sup-
          plied; otherwise qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee refuses to run.


     _n_o_t_l_s_h_o_s_t_s/<_F_Q_D_N>
          qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee will not try TLS on servers for which this
          file  exists (<<<<FFFFQQQQDDDDNNNN>>>> is the fully-qualified domain name
          of the server). (_t_l_s_h_o_s_t_s/<_F_Q_D_N>._p_e_m  takes  precedence
          over this file however).


     _o_u_t_g_o_i_n_g_i_p
          IP  address  to  be  used  on   outgoing   connections.
          Default:   system-defined.    The   value   _0._0._0._0  is
          equivalent to the system default.


     _s_m_t_p_r_o_u_t_e_s
          Artificial  SMTP  routes.   Each  route  has  the  form
          _d_o_m_a_i_n::::_r_e_l_a_y,  without  any  extra  spaces.   If _d_o_m_a_i_n
          matches _h_o_s_t, qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee will connect to _r_e_l_a_y, as if
          _h_o_s_t  had  _r_e_l_a_y  as  its only MX.  (It will also avoid
          doing any CNAME lookups on _r_e_c_i_p.)  _h_o_s_t may include  a
          colon  and  a  port number to use instead of the normal
          SMTP port, 25:

             inside.af.mil:firewall.af.mil:26



SunOS 5.11                Last change:                          2






Maintenance Procedures                            qmail-remote(8)



          _r_e_l_a_y may be empty; this tells qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee to look  up
          MX  records  as  usual.   _p_o_r_t value of 465 (deprecated
          smtps  port)  causes  TLS  session   to   be   started.
          _s_m_t_p_r_o_u_t_e_s may include wildcards:

             .af.mil:
             :heaven.af.mil

          Here any address ending with ....aaaaffff....mmmmiiiillll  (but  not  aaaaffff....mmmmiiiillll
          itself)  is routed by its MX records; any other address
          is artificially routed to hhhheeeeaaaavvvveeeennnn....aaaaffff....mmmmiiiillll.

          The qqqqmmmmaaaaiiiillll system does not protect you if you create  an
          artificial  mail  loop  between machines.  However, you
          are always safe using _s_m_t_p_r_o_u_t_e_s if you do  not  accept
          mail from the network.

     _t_i_m_e_o_u_t_c_o_n_n_e_c_t
          Number of seconds qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee will wait for the remote
          SMTP  server to accept a connection.  Default: 60.  The
          kernel normally imposes a 75-second upper limit.

     _t_i_m_e_o_u_t_r_e_m_o_t_e
          Number of  seconds  qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee  will  wait  for  each
          response from the remote SMTP server.  Default: 1200.


     _t_l_s_c_l_i_e_n_t_c_i_p_h_e_r_s
          A  set  of  OpenSSL  client  cipher  strings.  Multiple
          ciphers  contained in a string should be separated by a
          colon.


     _t_l_s_h_o_s_t_s/<_F_Q_D_N>._p_e_m
          qqqqmmmmaaaaiiiillll----rrrreeeemmmmooootttteeee requires TLS authentication  from  servers
          for  which  this  file  exists  (<<<<FFFFQQQQDDDDNNNN>>>>  is  the fully-
          qualified domain  name  of  the  server).  One  of  the
          _d_N_S_N_a_m_e or the _C_o_m_m_o_n_N_a_m_e attributes have to match. The
          file contains the trusted CA certificates.

          WWWWAAAARRRRNNNNIIIINNNNGGGG:::: this option may  cause  mail  to  be  delayed,
          bounced, doublebounced, or lost.


     _t_l_s_h_o_s_t_s/_e_x_h_a_u_s_t_i_v_e_l_i_s_t
          if this file exists no TLS will be tried on hosts other
          than those for which a file ttttllllsssshhhhoooossssttttssss////<<<<FFFFQQQQDDDDNNNN>>>>....ppppeeeemmmm exists.


SSSSEEEEEEEE AAAALLLLSSSSOOOO
     addresses(5), envelopes(5), qmail-control(5), qmail-send(8),
     qmail-smtpd(8), qmail-tcpok(8), qmail-tcpto(8)



SunOS 5.11                Last change:                          3