qmail-queue.8 (3557B)
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 should 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 44 Programs included with qmail which invoke 45 .B qmail-queue 46 will invoke the contents of 47 .B $QMAILQUEUE 48 instead, if that environment variable is set. 49 .SH "FILESYSTEM RESTRICTIONS" 50 .B qmail-queue 51 imposes two constraints on the queue structure: 52 each 53 .B mess 54 subdirectory must be in the same filesystem as the 55 .B pid 56 directory; and each 57 .B todo 58 subdirectory must be in the same filesystem as the 59 .B intd 60 directory. 61 .SH "EXIT CODES" 62 .B qmail-queue 63 does not print diagnostics. 64 It exits 65 0 if 66 it has successfully queued the message. 67 It exits between 1 and 99 if 68 it has failed to queue the message. 69 70 All 71 .B qmail-queue 72 error codes between 11 and 40 73 indicate permanent errors: 74 .TP 5 75 .B 11 76 Address too long. 77 .TP 78 .B 31 79 Mail server permanently refuses to send the message to any recipients. 80 (Not used by 81 .BR qmail-queue , 82 but can be used by programs offering the same interface.) 83 .PP 84 A special 85 .B qmail-queue 86 error code indicates a custom error string is written to descriptor 6: 87 .TP 5 88 .B 82 89 Mail server refuses to send the message to any recipients: 90 permanently for strings starting with "D", 91 temporarily for strings starting with "Z". 92 (Not used by 93 .BR qmail-queue , 94 but can be used by programs offering the same interface.) 95 .PP 96 All other 97 .B qmail-queue 98 error codes indicate temporary errors: 99 .TP 5 100 .B 51 101 Out of memory. 102 .TP 103 .B 52 104 Timeout. 105 .TP 106 .B 53 107 Write error; e.g., disk full. 108 .TP 109 .B 54 110 Unable to read the message or envelope. 111 .TP 112 .B 55 113 Unable to read a configuration file. 114 (Not used by 115 .BR qmail-queue .) 116 .TP 117 .B 56 118 Problem making a network connection from this host. 119 (Not used by 120 .BR qmail-queue .) 121 .TP 122 .B 61 123 Problem with the qmail home directory. 124 .TP 125 .B 62 126 Problem with the queue directory. 127 .TP 128 .B 63 129 Problem with queue/pid. 130 .TP 131 .B 64 132 Problem with queue/mess. 133 .TP 134 .B 65 135 Problem with queue/intd. 136 .TP 137 .B 66 138 Problem with queue/todo. 139 .TP 140 .B 71 141 Mail server temporarily refuses to send the message to any recipients. 142 (Not used by 143 .BR qmail-queue .) 144 .TP 145 .B 72 146 Connection to mail server timed out. 147 (Not used by 148 .BR qmail-queue .) 149 .TP 150 .B 73 151 Connection to mail server rejected. 152 (Not used by 153 .BR qmail-queue .) 154 .TP 155 .B 74 156 Connection to mail server succeeded, 157 but communication failed. 158 (Not used by 159 .BR qmail-queue .) 160 .TP 161 .B 81 162 Internal bug; e.g., segmentation fault. 163 .TP 164 .B 91 165 Envelope format error. 166 .SH "SEE ALSO" 167 addresses(5), 168 envelopes(5), 169 qmail-header(5), 170 qmail-inject(8), 171 qmail-qmqpc(8), 172 qmail-send(8), 173 qmail-smtpd(8)