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 | |
28 | must contain a username, | |
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) . | |
43 | .SH "EXIT CODES" | |
44 | 0 if | |
45 | .B qmail-queue | |
46 | has successfully queued the message, | |
47 | nonzero if | |
48 | .B qmail-queue | |
49 | has failed to queue the message. | |
50 | .B qmail-queue | |
51 | does not print diagnostics. | |
52 | .SH "SEE ALSO" | |
53 | addresses(5), | |
54 | envelopes(5), | |
55 | qmail-header(5), | |
56 | qmail-inject(8), | |
57 | qmail-send(8), | |
58 | qmail-smtpd(8) |