qmail-inject.8 (5596B)
1 .TH qmail-inject 8 2 .SH NAME 3 qmail-inject \- preprocess and send a mail message 4 .SH SYNOPSIS 5 .B qmail-inject 6 [ 7 .B \-nNaAhH 8 ] [ 9 .B \-f\fIsender 10 ] [ 11 .I recip ... 12 ] 13 .SH DESCRIPTION 14 .B qmail-inject 15 reads a mail message from its standard input, 16 adds appropriate information to the message header, 17 and invokes 18 .B qmail-queue 19 to send the message 20 to one or more recipients. 21 22 See 23 .B qmail-header(5) 24 for information on how 25 .B qmail-inject 26 rewrites header fields. 27 28 .B qmail-inject 29 normally exits 0. 30 It exits 100 if it was invoked improperly 31 or if there is a severe syntax error in the message. 32 It exits 111 for temporary errors. 33 .SH "ENVIRONMENT VARIABLES" 34 For the convenience of users who do not run 35 .B qmail-inject 36 directly, 37 .B qmail-inject 38 takes many options through environment variables. 39 40 The user name in the 41 .B From 42 header field is set by 43 .BR QMAILUSER , 44 .BR MAILUSER , 45 .BR USER , 46 or 47 .BR LOGNAME , 48 whichever comes first. 49 50 The host name is normally set by the 51 .I defaulthost 52 control 53 but can be overridden with 54 .B QMAILHOST 55 or 56 .BR MAILHOST . 57 58 The personal name is 59 .BR QMAILNAME , 60 .BR MAILNAME , 61 or 62 .BR NAME . 63 64 The default envelope sender address is the same as the 65 default 66 .B From 67 address, 68 but it can be overridden with 69 .B QMAILSUSER 70 and 71 .BR QMAILSHOST . 72 It may also be modified by the 73 .B r 74 and 75 .B m 76 letters described below. 77 Bounces will be sent to this address. 78 79 If 80 .B QMAILMFTFILE 81 is set, 82 .B qmail-inject 83 reads a list of mailing list addresses, 84 one per line, 85 from that file. 86 If To+Cc includes one of those addresses (without regard to case), 87 .B qmail-inject 88 adds a Mail-Followup-To field 89 with all the To+Cc addresses. 90 .B qmail-inject 91 does not add Mail-Followup-To 92 to a message that already has one. 93 94 The 95 .B QMAILINJECT 96 environment variable 97 can contain any of the following letters: 98 .TP 99 .B c 100 Use address-comment style for the 101 .B From 102 field. 103 Normally 104 .B qmail-inject 105 uses name-address style. 106 .TP 107 .B s 108 Do not look at any incoming 109 .B Return-Path 110 field. 111 Normally, if 112 .B Return-Path 113 is supplied, it sets the envelope sender address, 114 overriding all environment variables. 115 .B Return-Path 116 is deleted in any case. 117 .TP 118 .B f 119 Delete any incoming 120 .B From 121 field. 122 Normally, if 123 .B From 124 is supplied, it overrides the usual 125 .B From 126 field created by 127 .BR qmail-inject . 128 .TP 129 .B i 130 Delete any incoming 131 .B Message-ID 132 field. 133 Normally, if 134 .B Message-ID 135 is supplied, it overrides the usual 136 .B Message-ID 137 field created by 138 .BR qmail-inject . 139 .TP 140 .B r 141 Use a per-recipient VERP. 142 .B qmail-inject 143 will append each recipient address to the envelope sender 144 of the copy going to that recipient. 145 .TP 146 .B m 147 Use a per-message VERP. 148 .B qmail-inject 149 will append the current date and process ID to the envelope sender. 150 .SH OPTIONS 151 .TP 152 .B \-a 153 Send the message to all addresses given as 154 .I recip 155 arguments; 156 do not use header recipient addresses. 157 .TP 158 .B \-h 159 Send the message to all header recipient addresses. 160 For non-forwarded messages, this means 161 the addresses listed under 162 .BR To , 163 .BR Cc , 164 .BR Bcc , 165 .BR Apparently-To . 166 For forwarded messages, this means 167 the addresses listed under 168 .BR Resent-To , 169 .BR Resent-Cc , 170 .BR Resent-Bcc . 171 Do not use any 172 .I recip 173 arguments. 174 .TP 175 .B \-A 176 (Default.) 177 Send the message to all addresses given as 178 .I recip 179 arguments. 180 If no 181 .I recip 182 arguments are supplied, 183 send the message to all header recipient addresses. 184 .TP 185 .B \-H 186 Send the message to all header recipient addresses, 187 and to all addresses given as 188 .I recip 189 arguments. 190 .TP 191 .B \-f\fIsender 192 Pass 193 .I sender 194 to 195 .B qmail-queue 196 as the envelope sender address. 197 This overrides 198 .B Return-Path 199 and all environment variables. 200 .TP 201 .B \-N 202 (Default.) 203 Feed the resulting message to 204 .BR qmail-queue . 205 .TP 206 .B \-n 207 Print the message rather than feeding it to 208 .BR qmail-queue . 209 .SH "CONTROL FILES" 210 .TP 5 211 .I defaultdomain 212 Default domain name. 213 Default: 214 .IR me , 215 if that is supplied; 216 otherwise the literal name 217 .BR defaultdomain , 218 which is probably not what you want. 219 .B qmail-inject 220 adds this name to any host name without dots, 221 including 222 .I defaulthost 223 if 224 .I defaulthost 225 does not have dots. 226 (Exception: see 227 .IR plusdomain .) 228 229 The 230 .B QMAILDEFAULTDOMAIN 231 environment variable 232 overrides 233 .IR defaultdomain . 234 .TP 5 235 .I defaulthost 236 Default host name. 237 Default: 238 .IR me , 239 if that is supplied; 240 otherwise the literal name 241 .BR defaulthost , 242 which is probably not what you want. 243 .B qmail-inject 244 adds this name to any address without a host name. 245 .I defaulthost 246 need not be the current host's name. 247 For example, 248 you may prefer that outgoing mail show 249 just your domain name. 250 251 The 252 .B QMAILDEFAULTHOST 253 environment variable overrides 254 .IR defaulthost . 255 .TP 5 256 .I idhost 257 Host name for Message-IDs. 258 Default: 259 .IR me , 260 if that is supplied; 261 otherwise the literal name 262 .BR idhost , 263 which is certainly not what you want. 264 .I idhost 265 need not be the current host's name. 266 For example, you may prefer to use fake 267 host names in Message-IDs. 268 However, 269 .I idhost 270 must be a fully-qualified name within your domain, 271 and each host in your domain should use a different 272 .IR idhost . 273 274 The 275 .B QMAILIDHOST 276 environment variable overrides 277 .IR idhost . 278 .TP 5 279 .I plusdomain 280 Plus domain name. 281 Default: 282 .IR me , 283 if that is supplied; 284 otherwise the literal name 285 .BR plusdomain , 286 which is probably not what you want. 287 .B qmail-inject 288 adds this name to any host name that ends with a plus sign, 289 including 290 .I defaulthost 291 if 292 .I defaulthost 293 ends with a plus sign. 294 If a host name does not have dots but ends with a plus sign, 295 .B qmail-inject 296 uses 297 .IR plusdomain , 298 not 299 .IR defaultdomain . 300 301 The 302 .B QMAILPLUSDOMAIN 303 environment variable overrides 304 .IR plusdomain . 305 .SH "SEE ALSO" 306 addresses(5), 307 qmail-control(5), 308 qmail-header(5), 309 qmail-queue(8)