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


NAME
       qmail-outbox-queue - queue a mail message for delivery

SYNOPSIS
       qmail-outbox-queue

DESCRIPTION
       qmail-outbox-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 BR 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-
       outbox-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-outbox-queue always adds a Received line to the  top
       of the message.  In contrast to qmail-queue, qmail-outbox-
       queue inspects the message, looking for large  attachments
       and   piping   them   to   bin/outboxer.   The  stdout  of
       bin/outboxer is expected to be a URL where the  attachment
       can be retrieved by the mail recipient.


CONTROL FILES
       maxattachlen  Length  of  maximum attachment left alone by
       qmail-outbox-queue.  Absence of this file  or  a  value  0
       means outboxing is deactivated.


FILESYSTEM RESTRICTIONS
       qmail-outbox-queue  imposes  two  constraints on the queue
       structure: each mess subdirectory  must  be  in  the  same
       filesystem  as  the pid directory; and each todo subdirec-
       tory must be in the same filesystem as the intd directory.

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

       11   Address too long.




                                                                1





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


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

       All  other  qmail-outbox-queue error codes indicate tempo-
       rary errors:

       51   Out of memory.

       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-outbox-queue.)

       56   Problem  making  a network connection from this host.
            (Not used by qmail-outbox-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.


       68   Problem with outboxing.

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

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

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

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

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

       91   Envelope format error.





                                                                2





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


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





















































                                                                3