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

1994 Man-cgi 1.15, Panagiotis Christias <christia@theseas.ntua.gr>