qmail-queue(8)                                                  qmail-queue(8)



NNAAMMEE
       qmail-queue - queue a mail message for delivery

SSYYNNOOPPSSIISS
       qqmmaaiill--qquueeuuee

DDEESSCCRRIIPPTTIIOONN
       qqmmaaiill--qquueeuuee  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 qqmmaaiill--sseenndd.

       The  envelope  information  is an envelope sender address followed 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 qqmmaaiill--qquueeuuee
       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.

       qqmmaaiill--qquueeuuee always adds a RReecceeiivveedd line to  the  top  of  the  message.
       Other  than this, qqmmaaiill--qquueeuuee does not inspect the message and does not
       enforce any restrictions on  its  contents.   However,  the  recipients
       probably  expect  to  see  a  proper  header,  as  described  in qqmmaaiill--
       hheeaaddeerr((55)).

FFIILLEESSYYSSTTEEMM RREESSTTRRIICCTTIIOONNSS
       qqmmaaiill--qquueeuuee imposes two constraints on the queue structure:  each  mmeessss
       subdirectory  must  be in the same filesystem as the ppiidd directory; and
       each ttooddoo subdirectory must be in  the  same  filesystem  as  the  iinnttdd
       directory.

EEXXIITT CCOODDEESS
       qqmmaaiill--qquueeuuee  does not print diagnostics.  It exits 0 if it has success-
       fully queued the message.  It exits between 1 and 99 if it  has  failed
       to queue the message.

       All  qqmmaaiill--qquueeuuee  error  codes  between  11  and  40 indicate permanent
       errors:

       1111   Address too long.

       3311   Mail server permanently refuses to send the message to any recipi-
            ents.   (Not  used  by  qqmmaaiill--qquueeuuee,  but  can be used by programs
            offering the same interface.)

       All other qqmmaaiill--qquueeuuee error codes indicate temporary errors:

       5511   Out of memory.

       5522   Timeout.

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

       5544   Unable to read the message or envelope.

       5555   Unable to read a configuration file.  (Not used by qqmmaaiill--qquueeuuee.)

       5566   Problem making a network connection from this host.  (Not used  by
            qqmmaaiill--qquueeuuee.)

       6611   Problem with the qmail home directory.

       6622   Problem with the queue directory.

       6633   Problem with queue/pid.

       6644   Problem with queue/mess.

       6655   Problem with queue/intd.

       6666   Problem with queue/todo.

       7711   Mail server temporarily refuses to send the message to any recipi-
            ents.  (Not used by qqmmaaiill--qquueeuuee.)

       7722   Connection to mail server timed out.  (Not used by qqmmaaiill--qquueeuuee.)

       7733   Connection to mail server rejected.  (Not used by qqmmaaiill--qquueeuuee.)

       7744   Connection to mail server  succeeded,  but  communication  failed.
            (Not used by qqmmaaiill--qquueeuuee.)

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

       9911   Envelope format error.

SSEEEE AALLSSOO
       addresses(5),  envelopes(5),  qmail-header(5),  qmail-inject(8), qmail-
       qmqpc(8), qmail-send(8), qmail-smtpd(8)



                                                                qmail-queue(8)