path: root/qmail-queue.8
diff options
Diffstat (limited to 'qmail-queue.8')
1 files changed, 161 insertions, 0 deletions
diff --git a/qmail-queue.8 b/qmail-queue.8
new file mode 100644
index 0000000..ded3285
--- /dev/null
+++ b/qmail-queue.8
@@ -0,0 +1,161 @@
+.TH qmail-queue 8
+qmail-queue \- queue a mail message for delivery
+.B qmail-queue
+.B 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
+.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 recipient addresses is terminated by an extra 0 byte.
+.B 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.
+.B qmail-queue
+always adds a
+.B Received
+line to the top of the message.
+Other than this,
+.B 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
+.BR qmail-header(5) .
+Programs included with qmail which invoke
+.B qmail-queue
+will invoke the contents of
+instead, if that environment variable is set.
+.B qmail-queue
+imposes two constraints on the queue structure:
+.B mess
+subdirectory must be in the same filesystem as the
+.B pid
+directory; and each
+.B todo
+subdirectory must be in the same filesystem as the
+.B intd
+.B 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.
+.B qmail-queue
+error codes between 11 and 40
+indicate permanent errors:
+.TP 5
+.B 11
+Address too long.
+.B 31
+Mail server permanently refuses to send the message to any recipients.
+(Not used by
+.BR qmail-queue ,
+but can be used by programs offering the same interface.)
+All other
+.B qmail-queue
+error codes indicate temporary errors:
+.TP 5
+.B 51
+Out of memory.
+.B 52
+.B 53
+Write error; e.g., disk full.
+.B 54
+Unable to read the message or envelope.
+.B 55
+Unable to read a configuration file.
+(Not used by
+.BR qmail-queue .)
+.B 56
+Problem making a network connection from this host.
+(Not used by
+.BR qmail-queue .)
+.B 61
+Problem with the qmail home directory.
+.B 62
+Problem with the queue directory.
+.B 63
+Problem with queue/pid.
+.B 64
+Problem with queue/mess.
+.B 65
+Problem with queue/intd.
+.B 66
+Problem with queue/todo.
+.B 71
+Mail server temporarily refuses to send the message to any recipients.
+(Not used by
+.BR qmail-queue .)
+.B 72
+Connection to mail server timed out.
+(Not used by
+.BR qmail-queue .)
+.B 73
+Connection to mail server rejected.
+(Not used by
+.BR qmail-queue .)
+.B 74
+Connection to mail server succeeded,
+but communication failed.
+(Not used by
+.BR qmail-queue .)
+.B 81
+Internal bug; e.g., segmentation fault.
+.B 91
+Envelope format error.