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

NAME
       qmail-queue - queue a mail message for delivery

SYNOPSIS
       qmail-queue

DESCRIPTION
       qmail-queue  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 qmail-send.

       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  recipi-
       ent addresses is terminated by an extra 0 byte.  If qmail-
       queue 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 user-
       name, an @ sign, and a fully qualified domain name.

       qmail-queue always adds a Received line to the top of  the
       message.   Other  than  this, qmail-queue 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 qmail-header(5).

FILESYSTEM RESTRICTIONS
       qmail-queue imposes two constraints on  the  queue  struc-
       ture:  each mess subdirectory must be in the same filesys-
       tem as the pid directory; and each todo subdirectory  must
       be in the same filesystem as the intd directory.

EXIT CODES
       qmail-queue  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  qmail-queue  error  codes  between 11 and 40 indicate
       permanent errors:

       11   Address too long.

       31   Mail server permanently refuses to send  the  message
            to any recipients.  (Not used by qmail-queue, but can
            be used by programs offering the same interface.)

       All  other  qmail-queue  error  codes  indicate  temporary
       errors:

       51   Out of memory.

                                                                1

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

       52   Timeout.

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

       54   Unable to read the message or envelope.

       55   Unable  to  read  a configuration file.  (Not used by
            qmail-queue.)

       56   Problem making a network connection from  this  host.
            (Not used by qmail-queue.)

       61   Problem with the qmail home directory.

       62   Problem with the queue directory.

       63   Problem with queue/pid.

       64   Problem with queue/mess.

       65   Problem with queue/intd.

       66   Problem with queue/todo.

       71   Mail  server  temporarily refuses to send the message
            to any recipients.  (Not used by qmail-queue.)

       72   Connection to mail server timed out.   (Not  used  by
            qmail-queue.)

       73   Connection  to  mail  server  rejected.  (Not used by
            qmail-queue.)

       74   Connection to mail server succeeded,  but  communica-
            tion failed.  (Not used by qmail-queue.)

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

       91   Envelope format error.

SEE ALSO
       addresses(5),    envelopes(5),   qmail-header(5),   qmailinject(8)
       , qmail-qmqpc(8), qmail-send(8), qmail-smtpd(8)

                                                                2