qmail-queue
Section: Maintenance Commands (8)
Index
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.
ENVIRONMENT VARIABLES
- SPAMREFUSE
-
Maximum acceptable score from Spam Assassin (assumes Spam Assassin
has processed the message prior to reception by
qmail-queue,
typically via Spam Assassin's
qmail-spamc).
Messages are rejected if the (first, if more than one)
X-Spam-Status:
header shows a score higher than
SPAMREFUSE.
If no
X-Spam-Status:
header is found the message is accepted. Up to 2 decimal places are
significant in the
SPAMREFUSE
value. The
nospamrefuse
control file disables
SPAMREFUSE
for particular addresses, see the
qmail-smtpd
man page.
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.)
- 32
-
Message rejected since it appears to be spam (the
X-Spam-Status:
score exceeded
SPAMREFUSE).
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- FILESYSTEM RESTRICTIONS
-
- ENVIRONMENT VARIABLES
-
- EXIT CODES
-
- SEE ALSO
-
This document was created by man2html,
using the manual pages.
Time: 17:15:43 GMT, August 28, 2009