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 recipient 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 username, 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).
Programs included with qmail which invoke qmail-queue will invoke the contents of $QMAILQUEUE instead, if that environment variable is set.
FILESYSTEM RESTRICTIONS
qmail-queue imposes two constraints on the queue structure: each mess subdirectory must be in the same filesystem 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. | ||
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 communication 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), qmail-inject(8), qmail-qmqpc(8), qmail-send(8), qmail-smtpd(8)