Maintenance Procedures                             qmail-queue(8)



NNNNAAAAMMMMEEEE
     qmail-queue - queue a mail message for delivery

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee reads a mail message from descriptor 0.  It then
     reads envelope information from descriptor 1.  It places the
     message into the  outgoing  queue  for  future  delivery  by
     qqqqmmmmaaaaiiiillll----sssseeeennnndddd.

     The envelope information is an envelope sender address  fol-
     lowed by a list of envelope recipient addresses.  The sender
     address is preceded by the letter F and terminated  by  a  0
     byte.   Each  recipient  address is preceded by the letter T
     and terminated by a 0 byte.  The list of recipient addresses
     is  terminated by an extra 0 byte.  If qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee sees end-
     of-file before the extra 0 byte, it aborts  without  placing
     the message into the queue.

     Every envelope recipient address should contain a  username,
     an @ sign, and a fully qualified domain name.

     qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee always adds a RRRReeeecccceeeeiiiivvvveeeedddd line to the  top  of  the
     message.   Other than this, qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee does not inspect the
     message and does not enforce any restrictions  on  its  con-
     tents.   However,  the  recipients  probably expect to see a
     proper header, as described in qqqqmmmmaaaaiiiillll----hhhheeeeaaaaddddeeeerrrr((((5555)))).

     Programs included with qmail which invoke  qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee  will
     invoke the contents of $$$$QQQQMMMMAAAAIIIILLLLQQQQUUUUEEEEUUUUEEEE instead, if that environ-
     ment variable is set.

FFFFIIIILLLLEEEESSSSYYYYSSSSTTTTEEEEMMMM RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
     qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee imposes two constraints on the queue  structure:
     each mmmmeeeessssssss subdirectory must be in the same filesystem as the
     ppppiiiidddd directory; and each ttttooooddddoooo subdirectory  must  be  in  the
     same filesystem as the iiiinnnnttttdddd directory.

EEEEXXXXIIIITTTT CCCCOOOODDDDEEEESSSS
     qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee does not print diagnostics.  It exits  0  if  it
     has successfully queued the message.  It exits between 1 and
     99 if it has failed to queue the message.

     All qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee error codes between 11 and 40 indicate  per-
     manent errors:

     11111111   Address too long.

     33331111   Mail server permanently refuses to send the message  to
          any  recipients.   (Not used by qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee, but can be



SunOS 5.11                Last change:                          1






Maintenance Procedures                             qmail-queue(8)



          used by programs offering the same interface.)

     All other qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee error codes indicate temporary errors:

     55551111   Out of memory.

     55552222   Timeout.

     55553333   Write error; e.g., disk full.

     55554444   Unable to read the message or envelope.

     55555555   Unable to read a  configuration  file.   (Not  used  by
          qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     55556666   Problem making a network  connection  from  this  host.
          (Not used by qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     66661111   Problem with the qmail home directory.

     66662222   Problem with the queue directory.

     66663333   Problem with queue/pid.

     66664444   Problem with queue/mess.

     66665555   Problem with queue/intd.

     66666666   Problem with queue/todo.

     77771111   Mail server temporarily refuses to send the message  to
          any recipients.  (Not used by qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     77772222   Connection to mail server  timed  out.   (Not  used  by
          qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     77773333   Connection to  mail  server  rejected.   (Not  used  by
          qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     77774444   Connection to mail server succeeded, but  communication
          failed.  (Not used by qqqqmmmmaaaaiiiillll----qqqquuuueeeeuuuueeee.)

     88881111   Internal bug; e.g., segmentation fault.

     99991111   Envelope format error.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     addresses(5),    envelopes(5),    qmail-header(5),    qmail-
     inject(8), qmail-qmqpc(8), qmail-send(8), qmail-smtpd(8)






SunOS 5.11                Last change:                          2