qmail-queue - queue a mail message for delivery
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).
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.
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
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
51 Out of memory.
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
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
73 Connection to mail server rejected. (Not used by
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.
addresses(5), envelopes(5), qmail-header(5), qmailinject(8)
, qmail-qmqpc(8), qmail-send(8), qmail-smtpd(8)
© 1994 Man-cgi 1.15, Panagiotis Christias <email@example.com>