Current File : //var/qmail/man/cat8/qmail-send.0


Maintenance Procedures                              qmail-send(8)



NNNNAAAAMMMMEEEE
     qmail-send - deliver mail messages from the queue

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     qqqqmmmmaaaaiiiillll----sssseeeennnndddd

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     qqqqmmmmaaaaiiiillll----sssseeeennnndddd handles messages placed into the  outgoing  queue
     by qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.  It uses qqqqmmmmaaaaiiiillll----llllssssppppaaaawwwwnnnn to deliver messages to
     local recipients and qqqqmmmmaaaaiiiillll----rrrrssssppppaaaawwwwnnnn  to  deliver  messages  to
     remote  recipients.   If a message is temporarily undeliver-
     able to one or more addresses, qqqqmmmmaaaaiiiillll----sssseeeennnndddd leaves it  in  the
     queue and tries the addresses again later.

     qqqqmmmmaaaaiiiillll----sssseeeennnndddd prints a readable record  of  its  activities  to
     descriptor  0.   It  writes commands to qqqqmmmmaaaaiiiillll----llllssssppppaaaawwwwnnnn, qqqqmmmmaaaaiiiillll----
     rrrrssssppppaaaawwwwnnnn, and qqqqmmmmaaaaiiiillll----cccclllleeeeaaaannnn on descriptors  1,  3,  and  5,  and
     reads responses from descriptors 2, 4, and 6.  qqqqmmmmaaaaiiiillll----sssseeeennnndddd is
     responsible for avoiding deadlock.

     If qqqqmmmmaaaaiiiillll----sssseeeennnndddd receives a TERM signal, it will exit  cleanly,
     after  waiting  (possibly  more  than  a minute) for current
     delivery attempts to finish.

     If qqqqmmmmaaaaiiiillll----sssseeeennnndddd receives an ALRM signal,  it  will  reschedule
     every message in the queue for immediate delivery.

CCCCOOOONNNNTTTTRRRROOOOLLLL FFFFIIIILLLLEEEESSSS
     WWWWAAAARRRRNNNNIIIINNNNGGGG:::: qqqqmmmmaaaaiiiillll----sssseeeennnndddd reads its control  files  only  when  it
     starts.   If you change the control files, you must stop and
     restart qqqqmmmmaaaaiiiillll----sssseeeennnndddd.  Exception:  If  qqqqmmmmaaaaiiiillll----sssseeeennnndddd  receives  a
     HUP  signal,  it  will  reread  _c_o_n_c_u_r_r_e_n_c_y_l_o_c_a_l, _c_o_n_c_u_r_r_e_n_-
     _c_y_r_e_m_o_t_e, _l_o_c_a_l_s and _v_i_r_t_u_a_l_d_o_m_a_i_n_s.

     _b_o_u_n_c_e_f_r_o_m
          Bounce username.  Default:  MMMMAAAAIIIILLLLEEEERRRR----DDDDAAAAEEEEMMMMOOOONNNN.

     _b_o_u_n_c_e_h_o_s_t
          Bounce host.  Default:  _m_e, if that is supplied; other-
          wise the literal name bbbboooouuuunnnncccceeeehhhhoooosssstttt, which is probably not
          what you want.  If a message is permanently  undeliver-
          able,  qqqqmmmmaaaaiiiillll----sssseeeennnndddd  sends a ssssiiiinnnngggglllleeee----bbbboooouuuunnnncccceeee notice back to
          the message's envelope sender.   The  notice  is  FFFFrrrroooommmm::::
          _b_o_u_n_c_e_f_r_o_m@@@@_b_o_u_n_c_e_h_o_s_t,  although its envelope sender is
          empty.

     _c_o_n_c_u_r_r_e_n_c_y_l_o_c_a_l
          Maximum number of simultaneous local delivery attempts.
          Default:  10.   If  0,  local deliveries will be put on
          hold.  _c_o_n_c_u_r_r_e_n_c_y_l_o_c_a_l is limited at compile  time  to
          509.




SunOS 5.11                Last change:                          1






Maintenance Procedures                              qmail-send(8)



     _c_o_n_c_u_r_r_e_n_c_y_r_e_m_o_t_e
          Maximum  number   of   simultaneous   remote   delivery
          attempts.   Default:  20.  If 0, remote deliveries will
          be put on hold.  _c_o_n_c_u_r_r_e_n_c_y_r_e_m_o_t_e is limited  at  com-
          pile time to 509.

     _d_o_u_b_l_e_b_o_u_n_c_e_h_o_s_t
          Double-bounce host.  Default:  _m_e, if that is supplied;
          otherwise  the  literal name ddddoooouuuubbbblllleeeebbbboooouuuunnnncccceeeehhhhoooosssstttt, which is
          probably not what you want.

     _d_o_u_b_l_e_b_o_u_n_c_e_t_o
          User to receive double-bounces.  Default:   ppppoooossssttttmmmmaaaasssstttteeeerrrr.
          If a single-bounce notice is permanently undeliverable,
          qqqqmmmmaaaaiiiillll----sssseeeennnndddd   sends   a    ddddoooouuuubbbblllleeee----bbbboooouuuunnnncccceeee    notice    to
          _d_o_u_b_l_e_b_o_u_n_c_e_t_o@@@@_d_o_u_b_l_e_b_o_u_n_c_e_h_o_s_t.    (If  that  bounces,
          qqqqmmmmaaaaiiiillll----sssseeeennnndddd gives up.)

     _e_n_v_n_o_a_t_h_o_s_t
          Presumed domain name for  addresses  without  @  signs.
          Default:   _m_e,  if  that  is  supplied;  otherwise  the
          literal name eeeennnnvvvvnnnnooooaaaatttthhhhoooosssstttt, which is  probably  not  what
          you  want.   If  qqqqmmmmaaaaiiiillll----sssseeeennnndddd  sees an envelope recipient
          address without an @ sign, it appends @@@@_e_n_v_n_o_a_t_h_o_s_t.

     _l_o_c_a_l_s
          List of domain names that  the  current  host  receives
          mail  for, one per line.  Default:  _m_e, if that is sup-
          plied; otherwise qqqqmmmmaaaaiiiillll----sssseeeennnndddd refuses to run.  An address
          _u_s_e_r@_d_o_m_a_i_n  is considered local if _d_o_m_a_i_n is listed in
          _l_o_c_a_l_s.

     _p_e_r_c_e_n_t_h_a_c_k
          List of domain names where the percent hack is applied.
          If  _d_o_m_a_i_n is listed in _p_e_r_c_e_n_t_h_a_c_k, any address of the
          form _u_s_e_r%_f_q_d_n@_d_o_m_a_i_n is rewritten as _u_s_e_r@_f_q_d_n.   _u_s_e_r
          may  contain  %,  so  the  percent  hack may be applied
          repeatedly.   qqqqmmmmaaaaiiiillll----sssseeeennnndddd  handles  _p_e_r_c_e_n_t_h_a_c_k   before
          _l_o_c_a_l_s.

     _q_u_e_u_e_l_i_f_e_t_i_m_e
          Number of seconds a message  can  stay  in  the  queue.
          Default:  604800  (one week).  After this time expires,
          qqqqmmmmaaaaiiiillll----sssseeeennnndddd will try the message once more, but it  will
          treat  any  temporary  delivery  failures  as permanent
          failures.

     _v_i_r_t_u_a_l_d_o_m_a_i_n_s
          List of virtual users or domains, one per line.  A vir-
          tual user has the form _u_s_e_r@@@@_d_o_m_a_i_n::::_p_r_e_p_e_n_d, without any
          extra  spaces.   When  qqqqmmmmaaaaiiiillll----sssseeeennnndddd  sees  the  recipient
          address   _u_s_e_r@@@@_d_o_m_a_i_n,   it  converts  it  to  _p_r_e_p_e_n_d----



SunOS 5.11                Last change:                          2






Maintenance Procedures                              qmail-send(8)



          _u_s_e_r@@@@_d_o_m_a_i_n and treats it as local.

          A virtual  domain  has  the  form  _d_o_m_a_i_n::::_p_r_e_p_e_n_d.   It
          applies  to any recipient address at _d_o_m_a_i_n.  For exam-
          ple, if

               nowhere.mil:joe-foo

          is  in  _v_i_r_t_u_a_l_d_o_m_a_i_n_s,  and  a  message  arrives   for
          iiiinnnnffffoooo@@@@nnnnoooowwwwhhhheeeerrrreeee....mmmmiiiillll, qqqqmmmmaaaaiiiillll----sssseeeennnndddd will rewrite the recipient
          address as  jjjjooooeeee----ffffoooooooo----iiiinnnnffffoooo@@@@nnnnoooowwwwhhhheeeerrrreeee....mmmmiiiillll  and  deliver  the
          message locally.

          _v_i_r_t_u_a_l_d_o_m_a_i_n_s may contain wildcards:

               .fax:uucp-fax
               :alias-catchall
               .nowhere.mil:joe-foo-host

          _v_i_r_t_u_a_l_d_o_m_a_i_n_s may also contain exceptions:   an  empty
          _p_r_e_p_e_n_d means that _d_o_m_a_i_n is not a virtual domain.

          qqqqmmmmaaaaiiiillll----sssseeeennnndddd handles _v_i_r_t_u_a_l_d_o_m_a_i_n_s after _l_o_c_a_l_s:   if  a
          domain  is  listed  in  _l_o_c_a_l_s, _v_i_r_t_u_a_l_d_o_m_a_i_n_s does not
          apply.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     nice(1),   addresses(5),   envelopes(5),   qmail-control(5),
     qmail-log(5),    qmail-queue(8),    qmail-clean(8),   qmail-
     lspawn(8), qmail-rspawn(8)

























SunOS 5.11                Last change:                          3