Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | .TH qmail-queue 8 |
2 | .SH NAME | |
3 | qmail-queue \- queue a mail message for delivery | |
4 | .SH SYNOPSIS | |
5 | .B qmail-queue | |
6 | .SH DESCRIPTION | |
7 | .B qmail-queue | |
8 | reads a mail message from descriptor 0. | |
9 | It then reads envelope information from descriptor 1. | |
10 | It places the message into the outgoing queue | |
11 | for future delivery by | |
12 | .BR qmail-send . | |
13 | ||
14 | The envelope information is | |
15 | an envelope sender address | |
16 | followed by a list of envelope recipient addresses. | |
17 | The sender address is preceded by the letter F | |
18 | and terminated by a 0 byte. | |
19 | Each recipient address is preceded by the letter T | |
20 | and terminated by a 0 byte. | |
21 | The list of recipient addresses is terminated by an extra 0 byte. | |
22 | If | |
23 | .B qmail-queue | |
24 | sees end-of-file before the extra 0 byte, | |
25 | it aborts without placing the message into the queue. | |
26 | ||
27 | Every envelope recipient address | |
212b6f5d | 28 | should contain a username, |
2117e02e MW |
29 | an @ sign, |
30 | and a fully qualified domain name. | |
31 | ||
32 | .B qmail-queue | |
33 | always adds a | |
34 | .B Received | |
35 | line to the top of the message. | |
36 | Other than this, | |
37 | .B qmail-queue | |
38 | does not inspect the message | |
39 | and does not enforce any restrictions on its contents. | |
40 | However, the recipients probably expect to see a proper header, | |
41 | as described in | |
42 | .BR qmail-header(5) . | |
212b6f5d MW |
43 | .SH "FILESYSTEM RESTRICTIONS" |
44 | .B qmail-queue | |
45 | imposes two constraints on the queue structure: | |
46 | each | |
47 | .B mess | |
48 | subdirectory must be in the same filesystem as the | |
49 | .B pid | |
50 | directory; and each | |
51 | .B todo | |
52 | subdirectory must be in the same filesystem as the | |
53 | .B intd | |
54 | directory. | |
2117e02e | 55 | .SH "EXIT CODES" |
2117e02e | 56 | .B qmail-queue |
212b6f5d MW |
57 | does not print diagnostics. |
58 | It exits | |
59 | 0 if | |
60 | it has successfully queued the message. | |
61 | It exits between 1 and 99 if | |
62 | it has failed to queue the message. | |
63 | ||
64 | All | |
2117e02e | 65 | .B qmail-queue |
212b6f5d MW |
66 | error codes between 11 and 40 |
67 | indicate permanent errors: | |
68 | .TP 5 | |
69 | .B 11 | |
70 | Address too long. | |
71 | .TP | |
72 | .B 31 | |
73 | Mail server permanently refuses to send the message to any recipients. | |
74 | (Not used by | |
75 | .BR qmail-queue , | |
76 | but can be used by programs offering the same interface.) | |
77 | .PP | |
78 | All other | |
2117e02e | 79 | .B qmail-queue |
212b6f5d MW |
80 | error codes indicate temporary errors: |
81 | .TP 5 | |
82 | .B 51 | |
83 | Out of memory. | |
84 | .TP | |
85 | .B 52 | |
86 | Timeout. | |
87 | .TP | |
88 | .B 53 | |
89 | Write error; e.g., disk full. | |
90 | .TP | |
91 | .B 54 | |
92 | Unable to read the message or envelope. | |
93 | .TP | |
94 | .B 55 | |
95 | Unable to read a configuration file. | |
96 | (Not used by | |
97 | .BR qmail-queue .) | |
98 | .TP | |
99 | .B 56 | |
100 | Problem making a network connection from this host. | |
101 | (Not used by | |
102 | .BR qmail-queue .) | |
103 | .TP | |
104 | .B 61 | |
105 | Problem with the qmail home directory. | |
106 | .TP | |
107 | .B 62 | |
108 | Problem with the queue directory. | |
109 | .TP | |
110 | .B 63 | |
111 | Problem with queue/pid. | |
112 | .TP | |
113 | .B 64 | |
114 | Problem with queue/mess. | |
115 | .TP | |
116 | .B 65 | |
117 | Problem with queue/intd. | |
118 | .TP | |
119 | .B 66 | |
120 | Problem with queue/todo. | |
121 | .TP | |
122 | .B 71 | |
123 | Mail server temporarily refuses to send the message to any recipients. | |
124 | (Not used by | |
125 | .BR qmail-queue .) | |
126 | .TP | |
127 | .B 72 | |
128 | Connection to mail server timed out. | |
129 | (Not used by | |
130 | .BR qmail-queue .) | |
131 | .TP | |
132 | .B 73 | |
133 | Connection to mail server rejected. | |
134 | (Not used by | |
135 | .BR qmail-queue .) | |
136 | .TP | |
137 | .B 74 | |
138 | Connection to mail server succeeded, | |
139 | but communication failed. | |
140 | (Not used by | |
141 | .BR qmail-queue .) | |
142 | .TP | |
143 | .B 81 | |
144 | Internal bug; e.g., segmentation fault. | |
145 | .TP | |
146 | .B 91 | |
147 | Envelope format error. | |
2117e02e MW |
148 | .SH "SEE ALSO" |
149 | addresses(5), | |
150 | envelopes(5), | |
151 | qmail-header(5), | |
152 | qmail-inject(8), | |
212b6f5d | 153 | qmail-qmqpc(8), |
2117e02e MW |
154 | qmail-send(8), |
155 | qmail-smtpd(8) |