Line 0
Link Here
|
|
|
1 |
--- ../MailScanner-4.30.3.orig/docs/man/MailScanner.conf.5.html Mon May 3 10:48:25 2004 |
2 |
+++ docs/man/MailScanner.conf.5.html Mon May 3 10:48:42 2004 |
3 |
@@ -1,5 +1,5 @@ |
4 |
<!-- Creator : groff version 1.19 --> |
5 |
-<!-- CreationDate: Fri Apr 2 12:23:58 2004 --> |
6 |
+<!-- CreationDate: Mon May 3 10:47:48 2004 --> |
7 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
8 |
"http://www.w3.org/TR/html4/loose.dtd"> |
9 |
<html> |
10 |
@@ -331,17 +331,85 @@ |
11 |
<!-- INDENTATION --> |
12 |
<p>Directory in which MailScanner should find e−mail |
13 |
messages for scanning. This can be any of the following:</p> |
14 |
+</td> |
15 |
+</table> |
16 |
+<!-- TABS --> |
17 |
+<table width="100%" border=0 rules="none" frame="void" |
18 |
+ cols="5" cellspacing="0" cellpadding="0"> |
19 |
+<tr valign="top" align="left"> |
20 |
+<td width="22%"></td> |
21 |
+<td width="3%"> |
22 |
+ |
23 |
+<p>1.</p> |
24 |
+</td> |
25 |
+<td width="3%"></td> |
26 |
+<td width="26%"> |
27 |
+ |
28 |
+<p>a directory name.</p> |
29 |
+</td> |
30 |
+<td width="46%"> |
31 |
+</td> |
32 |
+</table> |
33 |
<!-- INDENTATION --> |
34 |
-<p>1. a directory name. Example: /var/spool/mqueue.in</p> |
35 |
-<!-- INDENTATION --> |
36 |
-<p>2. a wildcard giving directory names. Example: |
37 |
-/var/spool/mqueue.in/*</p> |
38 |
+<table width="100%" border=0 rules="none" frame="void" |
39 |
+ cols="2" cellspacing="0" cellpadding="0"> |
40 |
+<tr valign="top" align="left"> |
41 |
+<td width="28%"></td> |
42 |
+<td width="72%"> |
43 |
+<p>Example: /var/spool/mqueue.in</p> |
44 |
+</td> |
45 |
+</table> |
46 |
+<!-- TABS --> |
47 |
+<table width="100%" border=0 rules="none" frame="void" |
48 |
+ cols="5" cellspacing="0" cellpadding="0"> |
49 |
+<tr valign="top" align="left"> |
50 |
+<td width="22%"></td> |
51 |
+<td width="3%"> |
52 |
+ |
53 |
+<p>2.</p> |
54 |
+</td> |
55 |
+<td width="3%"></td> |
56 |
+<td width="52%"> |
57 |
+ |
58 |
+<p>a wildcard giving directory names.</p> |
59 |
+</td> |
60 |
+<td width="20%"> |
61 |
+</td> |
62 |
+</table> |
63 |
<!-- INDENTATION --> |
64 |
-<p>3. the name of a file containing a list of directory |
65 |
-names, which can in turn contain wildcards. Example: |
66 |
-/usr/local/etc/MailScanner/mqueue.in.list.conf</p> |
67 |
+<table width="100%" border=0 rules="none" frame="void" |
68 |
+ cols="2" cellspacing="0" cellpadding="0"> |
69 |
+<tr valign="top" align="left"> |
70 |
+<td width="28%"></td> |
71 |
+<td width="72%"> |
72 |
+<p>Example: /var/spool/mqueue.in/*</p> |
73 |
</td> |
74 |
</table> |
75 |
+<!-- TABS --> |
76 |
+<table width="100%" border=0 rules="none" frame="void" |
77 |
+ cols="4" cellspacing="0" cellpadding="0"> |
78 |
+<tr valign="top" align="left"> |
79 |
+<td width="22%"></td> |
80 |
+<td width="3%"> |
81 |
+ |
82 |
+<p>3.</p> |
83 |
+</td> |
84 |
+<td width="3%"></td> |
85 |
+<td width="72%"> |
86 |
+ |
87 |
+<p>the name of a file containing a list of directory names, |
88 |
+which can in turn contain wildcards.</p> |
89 |
+</td> |
90 |
+</table> |
91 |
+<!-- INDENTATION --> |
92 |
+<table width="100%" border=0 rules="none" frame="void" |
93 |
+ cols="2" cellspacing="0" cellpadding="0"> |
94 |
+<tr valign="top" align="left"> |
95 |
+<td width="28%"></td> |
96 |
+<td width="72%"> |
97 |
+<p>Example: |
98 |
+/usr/local/etc/MailScanner/mqueue.in.list.conf</p></td> |
99 |
+</table> |
100 |
<!-- INDENTATION --> |
101 |
<table width="100%" border=0 rules="none" frame="void" |
102 |
cols="2" cellspacing="0" cellpadding="0"> |
103 |
@@ -1403,29 +1471,79 @@ |
104 |
fake addresses on messages they send, so there is no point |
105 |
informing the sender of the message, as it won’t |
106 |
actually be them who sent it anyway. Other words that can be |
107 |
-put in this list are the 5 special keywords<br> |
108 |
-HTML−IFrame: inserting this will stop senders being |
109 |
-warned about HTML Iframe tags, when they are not |
110 |
-allowed.<br> |
111 |
-HTML−Codebase: inserting this will stop senders being |
112 |
-warned about HTML Object Codebase tags, when they are not |
113 |
-allowed.<br> |
114 |
-Zip−Password: inserting this will stop senders being |
115 |
-warned about password−protected zip files when they |
116 |
-are not allowd. This keyword is not needed if you include |
117 |
-All−Viruses.<br> |
118 |
-All−Viruses: inserting this will stop senders being |
119 |
-warned about any virus, while still allowing you to warn |
120 |
-senders about HTML−based attacks. This includes |
121 |
+put in this list are the 5 special keywords</p> |
122 |
+</td> |
123 |
+</table> |
124 |
+<!-- TABS --> |
125 |
+<table width="100%" border=0 rules="none" frame="void" |
126 |
+ cols="4" cellspacing="0" cellpadding="0"> |
127 |
+<tr valign="top" align="left"> |
128 |
+<td width="22%"></td> |
129 |
+<td width="1%"> |
130 |
+ |
131 |
+<p>•</p> |
132 |
+</td> |
133 |
+<td width="5%"></td> |
134 |
+<td width="72%"> |
135 |
+ |
136 |
+<p>HTML−IFrame: inserting this will stop senders |
137 |
+being warned about HTML Iframe tags, when they are not |
138 |
+allowed.</p> |
139 |
+</td> |
140 |
+<tr valign="top" align="left"> |
141 |
+<td width="22%"></td> |
142 |
+<td width="1%"> |
143 |
+ |
144 |
+<p>•</p> |
145 |
+</td> |
146 |
+<td width="5%"></td> |
147 |
+<td width="72%"> |
148 |
+ |
149 |
+<p>HTML−Codebase: inserting this will stop senders |
150 |
+being warned about HTML Object Codebase tags, when they are |
151 |
+not allowed.</p> |
152 |
+</td> |
153 |
+<tr valign="top" align="left"> |
154 |
+<td width="22%"></td> |
155 |
+<td width="1%"> |
156 |
+ |
157 |
+<p>•</p> |
158 |
+</td> |
159 |
+<td width="5%"></td> |
160 |
+<td width="72%"> |
161 |
+ |
162 |
+<p>Zip−Password: inserting this will stop senders |
163 |
+being warned about password−protected zip files when |
164 |
+they are not allowd. This keyword is not needed if you |
165 |
+include All−Viruses.</p> |
166 |
+</td> |
167 |
+<tr valign="top" align="left"> |
168 |
+<td width="22%"></td> |
169 |
+<td width="1%"> |
170 |
+ |
171 |
+<p>•</p> |
172 |
+</td> |
173 |
+<td width="5%"></td> |
174 |
+<td width="72%"> |
175 |
+ |
176 |
+<p>All−Viruses: inserting this will stop senders |
177 |
+being warned about any virus, while still allowing you to |
178 |
+warn senders about HTML−based attacks. This includes |
179 |
Zip−Password so you don’t need to include |
180 |
both.</p> |
181 |
+</td> |
182 |
+</table> |
183 |
<!-- INDENTATION --> |
184 |
+<table width="100%" border=0 rules="none" frame="void" |
185 |
+ cols="2" cellspacing="0" cellpadding="0"> |
186 |
+<tr valign="top" align="left"> |
187 |
+<td width="28%"></td> |
188 |
+<td width="72%"> |
189 |
<p>The default of "All−Viruses" means that |
190 |
no senders of viruses will be notified (as the sender |
191 |
address is always forged these days anyway), but anyone who |
192 |
sends a message that is blocked for other reasons will still |
193 |
-be notified.</p> |
194 |
-</td> |
195 |
+be notified.</p></td> |
196 |
</table> |
197 |
<!-- INDENTATION --> |
198 |
<table width="100%" border=0 rules="none" frame="void" |
199 |
@@ -1590,15 +1708,47 @@ |
200 |
Microsoft Outlook security vulnerabilities to go |
201 |
unprotected, but if you have a load of mailing lists sending |
202 |
them, then you will want to allow them to keep your users |
203 |
-happy. Possible Values:</p> |
204 |
-<!-- INDENTATION --> |
205 |
-<p>yes => Allow these tags to be in the message no => |
206 |
-Ban messages containing these tags disarm => Allow these |
207 |
-tags, but stop these tags from working</p> |
208 |
-<!-- INDENTATION --> |
209 |
-<p>This can also be the filename of a ruleset, so you can |
210 |
-allow them from known mailing lists but ban them from |
211 |
-everywhere else.</p> |
212 |
+happy. This can also be the filename of a ruleset, so you |
213 |
+can allow them from known mailing lists but ban them from |
214 |
+everywhere else. Possible Values:</p> |
215 |
+</td> |
216 |
+</table> |
217 |
+<!-- TABS --> |
218 |
+<table width="100%" border=0 rules="none" frame="void" |
219 |
+ cols="4" cellspacing="0" cellpadding="0"> |
220 |
+<tr valign="top" align="left"> |
221 |
+<td width="22%"></td> |
222 |
+<td width="1%"> |
223 |
+ |
224 |
+<p>•</p> |
225 |
+</td> |
226 |
+<td width="5%"></td> |
227 |
+<td width="72%"> |
228 |
+ |
229 |
+<p>yes => Allow these tags to be in the message</p> |
230 |
+</td> |
231 |
+<tr valign="top" align="left"> |
232 |
+<td width="22%"></td> |
233 |
+<td width="1%"> |
234 |
+ |
235 |
+<p>•</p> |
236 |
+</td> |
237 |
+<td width="5%"></td> |
238 |
+<td width="72%"> |
239 |
+ |
240 |
+<p>no => Ban messages containing these tags</p> |
241 |
+</td> |
242 |
+<tr valign="top" align="left"> |
243 |
+<td width="22%"></td> |
244 |
+<td width="1%"> |
245 |
+ |
246 |
+<p>•</p> |
247 |
+</td> |
248 |
+<td width="5%"></td> |
249 |
+<td width="72%"> |
250 |
+ |
251 |
+<p>disarm => Allow these tags, but stop these tags from |
252 |
+working</p> |
253 |
</td> |
254 |
</table> |
255 |
<!-- INDENTATION --> |
256 |
@@ -1615,8 +1765,14 @@ |
257 |
<tr valign="top" align="left"> |
258 |
<td width="22%"></td> |
259 |
<td width="78%"> |
260 |
-<p>Default: no</p> |
261 |
+<p>Default: no</p></td> |
262 |
+</table> |
263 |
<!-- INDENTATION --> |
264 |
+<table width="100%" border=0 rules="none" frame="void" |
265 |
+ cols="2" cellspacing="0" cellpadding="0"> |
266 |
+<tr valign="top" align="left"> |
267 |
+<td width="28%"></td> |
268 |
+<td width="72%"> |
269 |
<p>You may receive complaints from your users that HTML |
270 |
mailing lists they subscribe to have been stopped by the |
271 |
"Allow IFrame Tags" option above. So before you |
272 |
@@ -1649,10 +1805,44 @@ |
273 |
people to part with credit card information and other |
274 |
personal data. This can also be the filename of a ruleset. |
275 |
Possible values:</p> |
276 |
-<!-- INDENTATION --> |
277 |
-<p>yes => Allow these tags to be in the message no => |
278 |
-Ban messages containing these tags disarm => Allow these |
279 |
-tags, but stop these tags from working</p> |
280 |
+</td> |
281 |
+</table> |
282 |
+<!-- TABS --> |
283 |
+<table width="100%" border=0 rules="none" frame="void" |
284 |
+ cols="4" cellspacing="0" cellpadding="0"> |
285 |
+<tr valign="top" align="left"> |
286 |
+<td width="22%"></td> |
287 |
+<td width="1%"> |
288 |
+ |
289 |
+<p>•</p> |
290 |
+</td> |
291 |
+<td width="5%"></td> |
292 |
+<td width="72%"> |
293 |
+ |
294 |
+<p>yes => Allow these tags to be in the message</p> |
295 |
+</td> |
296 |
+<tr valign="top" align="left"> |
297 |
+<td width="22%"></td> |
298 |
+<td width="1%"> |
299 |
+ |
300 |
+<p>•</p> |
301 |
+</td> |
302 |
+<td width="5%"></td> |
303 |
+<td width="72%"> |
304 |
+ |
305 |
+<p>no => Ban messages containing these tags</p> |
306 |
+</td> |
307 |
+<tr valign="top" align="left"> |
308 |
+<td width="22%"></td> |
309 |
+<td width="1%"> |
310 |
+ |
311 |
+<p>•</p> |
312 |
+</td> |
313 |
+<td width="5%"></td> |
314 |
+<td width="72%"> |
315 |
+ |
316 |
+<p>disarm => Allow these tags, but stop these tags from |
317 |
+working</p> |
318 |
</td> |
319 |
</table> |
320 |
<!-- INDENTATION --> |
321 |
@@ -1669,18 +1859,57 @@ |
322 |
<tr valign="top" align="left"> |
323 |
<td width="22%"></td> |
324 |
<td width="78%"> |
325 |
-<p>Default: no</p> |
326 |
+<p>Default: no</p></td> |
327 |
+</table> |
328 |
<!-- INDENTATION --> |
329 |
+<table width="100%" border=0 rules="none" frame="void" |
330 |
+ cols="2" cellspacing="0" cellpadding="0"> |
331 |
+<tr valign="top" align="left"> |
332 |
+<td width="28%"></td> |
333 |
+<td width="72%"> |
334 |
<p>Do you want to allow <Object Codebase=...> tags in |
335 |
email messages? This is a bad idea as it leaves you |
336 |
unprotected against various Microsoft−specific |
337 |
security vulnerabilities. But if your users demand it, you |
338 |
can do it. This can also be the filename of a ruleset. |
339 |
-Possible values:</p> |
340 |
-<!-- INDENTATION --> |
341 |
-<p>yes => Allow these tags to be in the message no => |
342 |
-Ban messages containing these tags disarm => Allow these |
343 |
-tags, but stop these tags from working</p> |
344 |
+Possible values:</p></td> |
345 |
+</table> |
346 |
+<!-- TABS --> |
347 |
+<table width="100%" border=0 rules="none" frame="void" |
348 |
+ cols="4" cellspacing="0" cellpadding="0"> |
349 |
+<tr valign="top" align="left"> |
350 |
+<td width="22%"></td> |
351 |
+<td width="1%"> |
352 |
+ |
353 |
+<p>•</p> |
354 |
+</td> |
355 |
+<td width="5%"></td> |
356 |
+<td width="72%"> |
357 |
+ |
358 |
+<p>yes => Allow these tags to be in the message</p> |
359 |
+</td> |
360 |
+<tr valign="top" align="left"> |
361 |
+<td width="22%"></td> |
362 |
+<td width="1%"> |
363 |
+ |
364 |
+<p>•</p> |
365 |
+</td> |
366 |
+<td width="5%"></td> |
367 |
+<td width="72%"> |
368 |
+ |
369 |
+<p>no => Ban messages containing these tags</p> |
370 |
+</td> |
371 |
+<tr valign="top" align="left"> |
372 |
+<td width="22%"></td> |
373 |
+<td width="1%"> |
374 |
+ |
375 |
+<p>•</p> |
376 |
+</td> |
377 |
+<td width="5%"></td> |
378 |
+<td width="72%"> |
379 |
+ |
380 |
+<p>disarm => Allow these tags, but stop these tags from |
381 |
+working</p> |
382 |
</td> |
383 |
</table> |
384 |
<!-- INDENTATION --> |
385 |
@@ -1697,8 +1926,14 @@ |
386 |
<tr valign="top" align="left"> |
387 |
<td width="22%"></td> |
388 |
<td width="78%"> |
389 |
-<p>Default: no</p> |
390 |
+<p>Default: no</p></td> |
391 |
+</table> |
392 |
<!-- INDENTATION --> |
393 |
+<table width="100%" border=0 rules="none" frame="void" |
394 |
+ cols="2" cellspacing="0" cellpadding="0"> |
395 |
+<tr valign="top" align="left"> |
396 |
+<td width="28%"></td> |
397 |
+<td width="72%"> |
398 |
<p>This option interacts with the "Allow ... Tags" |
399 |
options above like this:</p> |
400 |
<!-- INDENTATION --> |
401 |
@@ -3670,6 +3905,32 @@ |
402 |
<tr valign="top" align="left"> |
403 |
<td width="11%"></td> |
404 |
<td width="89%"> |
405 |
+<p><b>Spam List Timeouts History</b></p></td> |
406 |
+</table> |
407 |
+<!-- INDENTATION --> |
408 |
+<table width="100%" border=0 rules="none" frame="void" |
409 |
+ cols="2" cellspacing="0" cellpadding="0"> |
410 |
+<tr valign="top" align="left"> |
411 |
+<td width="22%"></td> |
412 |
+<td width="78%"> |
413 |
+<p>Default: 10</p> |
414 |
+<!-- INDENTATION --> |
415 |
+<p>The total number of Spam List attempts during which |
416 |
+"Max Spam List Timeouts" will cause the spam list |
417 |
+fo be marked as "unavailable". See the previous |
418 |
+comment for more information. The default values of 5 and 10 |
419 |
+mean that 5 timeouts in any sequence of 10 attempts will |
420 |
+cause the list to be marked as "unavailable" until |
421 |
+the next periodic restart (see "Restart |
422 |
+Every").</p> |
423 |
+</td> |
424 |
+</table> |
425 |
+<!-- INDENTATION --> |
426 |
+<table width="100%" border=0 rules="none" frame="void" |
427 |
+ cols="2" cellspacing="0" cellpadding="0"> |
428 |
+<tr valign="top" align="left"> |
429 |
+<td width="11%"></td> |
430 |
+<td width="89%"> |
431 |
<p><b>Is Definitely Not Spam</b></p></td> |
432 |
</table> |
433 |
<!-- INDENTATION --> |
434 |
@@ -3733,6 +3994,31 @@ |
435 |
This can also be the filename of a ruleset.</p> |
436 |
</td> |
437 |
</table> |
438 |
+<!-- INDENTATION --> |
439 |
+<table width="100%" border=0 rules="none" frame="void" |
440 |
+ cols="2" cellspacing="0" cellpadding="0"> |
441 |
+<tr valign="top" align="left"> |
442 |
+<td width="11%"></td> |
443 |
+<td width="89%"> |
444 |
+<p><b>Ignore Spam Whitelist If Recipients |
445 |
+Exceed</b></p></td> |
446 |
+</table> |
447 |
+<!-- INDENTATION --> |
448 |
+<table width="100%" border=0 rules="none" frame="void" |
449 |
+ cols="2" cellspacing="0" cellpadding="0"> |
450 |
+<tr valign="top" align="left"> |
451 |
+<td width="22%"></td> |
452 |
+<td width="78%"> |
453 |
+<p>Default: 20</p> |
454 |
+<!-- INDENTATION --> |
455 |
+<p>Spammers have learnt that they can get their message |
456 |
+through by sending a message with lots of recipients, one of |
457 |
+which chooses to whitelist everything coming to them, |
458 |
+including the spammer. So if a message arrives with more |
459 |
+than this number of recipients, ignore the "Is |
460 |
+Definitely Not Spam" whitelist.</p> |
461 |
+</td> |
462 |
+</table> |
463 |
<a name="SpamAssassin"></a> |
464 |
<h2>SpamAssassin</h2> |
465 |
<!-- INDENTATION --> |
466 |
@@ -3868,11 +4154,7 @@ |
467 |
<tr valign="top" align="left"> |
468 |
<td width="22%"></td> |
469 |
<td width="78%"> |
470 |
-<p>Default: |
471 |
-/opt/MailScanner/etc/spam.assassin.prefs.conf<br> |
472 |
-Default Linux: /etc/MailScanner/spam.assassin.prefs.conf<br> |
473 |
-Default FreeBSD: |
474 |
-/usr/local/etc/MailScanner/spam.assassin.prefs.conf</p> |
475 |
+<p>Default: %etc−dir%/spam.assassin.prefs.conf</p> |
476 |
<!-- INDENTATION --> |
477 |
<p>SpamAssassin uses a "user preferences" file |
478 |
which can be used to set the values of various SpamAssassin |
479 |
@@ -3934,6 +4216,32 @@ |
480 |
<tr valign="top" align="left"> |
481 |
<td width="11%"></td> |
482 |
<td width="89%"> |
483 |
+<p><b>SpamAssassin Timeouts History</b></p></td> |
484 |
+</table> |
485 |
+<!-- INDENTATION --> |
486 |
+<table width="100%" border=0 rules="none" frame="void" |
487 |
+ cols="2" cellspacing="0" cellpadding="0"> |
488 |
+<tr valign="top" align="left"> |
489 |
+<td width="22%"></td> |
490 |
+<td width="78%"> |
491 |
+<p>Default: 30</p> |
492 |
+<!-- INDENTATION --> |
493 |
+<p>The total number of SpamAssassin attempts during which |
494 |
+"Max SpamAssassin Timeouts" will cause |
495 |
+SpamAssassin to be marked as "unavailable". See |
496 |
+the previous comment for more information. The default |
497 |
+values of 10 and 20 mean that 10 timeouts in any sequence of |
498 |
+20 attempts will trigger the behaviour described above, |
499 |
+until the next periodic restart (see "Restart |
500 |
+Every").</p> |
501 |
+</td> |
502 |
+</table> |
503 |
+<!-- INDENTATION --> |
504 |
+<table width="100%" border=0 rules="none" frame="void" |
505 |
+ cols="2" cellspacing="0" cellpadding="0"> |
506 |
+<tr valign="top" align="left"> |
507 |
+<td width="11%"></td> |
508 |
+<td width="89%"> |
509 |
<p><b>Check SpamAssassin If On Spam List</b></p></td> |
510 |
</table> |
511 |
<!-- INDENTATION --> |
512 |
@@ -4063,23 +4371,81 @@ |
513 |
<p>This can be any combination of 1 or more of the following |
514 |
keywords, and these actions are applied to any message which |
515 |
is spam.</p> |
516 |
-<!-- INDENTATION --> |
517 |
+</td> |
518 |
+</table> |
519 |
+<!-- TABS --> |
520 |
+<table width="100%" border=0 rules="none" frame="void" |
521 |
+ cols="4" cellspacing="0" cellpadding="0"> |
522 |
+<tr valign="top" align="left"> |
523 |
+<td width="22%"></td> |
524 |
+<td width="1%"> |
525 |
+ |
526 |
+<p>•</p> |
527 |
+</td> |
528 |
+<td width="5%"></td> |
529 |
+<td width="72%"> |
530 |
+ |
531 |
<p>"deliver" − the message is delivered to |
532 |
the recipient as normal</p> |
533 |
-<!-- INDENTATION --> |
534 |
+</td> |
535 |
+<tr valign="top" align="left"> |
536 |
+<td width="22%"></td> |
537 |
+<td width="1%"> |
538 |
+ |
539 |
+<p>•</p> |
540 |
+</td> |
541 |
+<td width="5%"></td> |
542 |
+<td width="72%"> |
543 |
+ |
544 |
<p>"delete" − the message is deleted</p> |
545 |
-<!-- INDENTATION --> |
546 |
+</td> |
547 |
+<tr valign="top" align="left"> |
548 |
+<td width="22%"></td> |
549 |
+<td width="1%"> |
550 |
+ |
551 |
+<p>•</p> |
552 |
+</td> |
553 |
+<td width="5%"></td> |
554 |
+<td width="72%"> |
555 |
+ |
556 |
<p>"store" − the message is stored in the |
557 |
quarantine</p> |
558 |
-<!-- INDENTATION --> |
559 |
-<p>"forward" − an email address is supplied, |
560 |
-to which the message is forwarded</p> |
561 |
-<!-- INDENTATION --> |
562 |
+</td> |
563 |
+<tr valign="top" align="left"> |
564 |
+<td width="22%"></td> |
565 |
+<td width="1%"> |
566 |
+ |
567 |
+<p>•</p> |
568 |
+</td> |
569 |
+<td width="5%"></td> |
570 |
+<td width="72%"> |
571 |
+ |
572 |
+<p>"forward" − an email address is |
573 |
+supplied, to which the message is forwarded</p> |
574 |
+</td> |
575 |
+<tr valign="top" align="left"> |
576 |
+<td width="22%"></td> |
577 |
+<td width="1%"> |
578 |
+ |
579 |
+<p>•</p> |
580 |
+</td> |
581 |
+<td width="5%"></td> |
582 |
+<td width="72%"> |
583 |
+ |
584 |
<p>"notify" − Send the recipients a short |
585 |
notification that spam addressed to them was not delivered. |
586 |
They can then take action to request retrieval of the |
587 |
orginal message if they think it was not spam.</p> |
588 |
-<!-- INDENTATION --> |
589 |
+</td> |
590 |
+<tr valign="top" align="left"> |
591 |
+<td width="22%"></td> |
592 |
+<td width="1%"> |
593 |
+ |
594 |
+<p>•</p> |
595 |
+</td> |
596 |
+<td width="5%"></td> |
597 |
+<td width="72%"> |
598 |
+ |
599 |
<p>"striphtml" − convert all in−line |
600 |
HTML content in the message to be stripped to plain text, |
601 |
which removes all images and scripts and so can be used to |
602 |
@@ -4087,12 +4453,30 @@ |
603 |
action on its own does not imply that the message will be |
604 |
delivered, you will need to specify "deliver" or |
605 |
"forward" to actually deliver the message.</p> |
606 |
-<!-- INDENTATION --> |
607 |
+</td> |
608 |
+<tr valign="top" align="left"> |
609 |
+<td width="22%"></td> |
610 |
+<td width="1%"> |
611 |
+ |
612 |
+<p>•</p> |
613 |
+</td> |
614 |
+<td width="5%"></td> |
615 |
+<td width="72%"> |
616 |
+ |
617 |
<p>"attachment" − Convert the original |
618 |
message into an attachment of the message. This means the |
619 |
user has to take an extra step to open the spam, and stops |
620 |
"web bugs" very effectively.</p> |
621 |
-<!-- INDENTATION --> |
622 |
+</td> |
623 |
+<tr valign="top" align="left"> |
624 |
+<td width="22%"></td> |
625 |
+<td width="1%"> |
626 |
+ |
627 |
+<p>•</p> |
628 |
+</td> |
629 |
+<td width="5%"></td> |
630 |
+<td width="72%"> |
631 |
+ |
632 |
<p>"bounce" − bounce the spam message. This |
633 |
option should not be used and must be enabled with the |
634 |
"Enable Spam Bounce" option first.</p> |
635 |
@@ -4112,8 +4496,14 @@ |
636 |
<tr valign="top" align="left"> |
637 |
<td width="22%"></td> |
638 |
<td width="78%"> |
639 |
-<p>Default: deliver</p> |
640 |
+<p>Default: deliver</p></td> |
641 |
+</table> |
642 |
<!-- INDENTATION --> |
643 |
+<table width="100%" border=0 rules="none" frame="void" |
644 |
+ cols="2" cellspacing="0" cellpadding="0"> |
645 |
+<tr valign="top" align="left"> |
646 |
+<td width="28%"></td> |
647 |
+<td width="72%"> |
648 |
<p>This is the same as the "Spam Actions" option |
649 |
above, but it gives the actions to apply to any message |
650 |
whose SpamAssassin score is above the "High |
651 |
@@ -4452,24 +4842,18 @@ |
652 |
Note the files are mutable. If this is unset then no extra |
653 |
places are searched for. If using Postfix, you probably want |
654 |
to set this to /var/spool/MailScanner/spamassassin and |
655 |
-do</p></td> |
656 |
+do</p> |
657 |
+</td> |
658 |
</table> |
659 |
-<!-- TABS --> |
660 |
+<!-- INDENTATION --> |
661 |
<table width="100%" border=0 rules="none" frame="void" |
662 |
cols="2" cellspacing="0" cellpadding="0"> |
663 |
<tr valign="top" align="left"> |
664 |
-<td width="29%"></td> |
665 |
-<td width="71%"> |
666 |
- |
667 |
-<p>mkdir /var/spool/MailScanner/spamassassin</p> |
668 |
-</td> |
669 |
-<tr valign="top" align="left"> |
670 |
-<td width="29%"></td> |
671 |
-<td width="71%"> |
672 |
- |
673 |
-<p>chown postfix.postfix |
674 |
-/var/spool/MailScanner/spamassassin</p> |
675 |
-</td> |
676 |
+<td width="26%"></td> |
677 |
+<td width="74%"> |
678 |
+<p>mkdir /var/spool/MailScanner/spamassassin<br> |
679 |
+chown postfix.postfix |
680 |
+/var/spool/MailScanner/spamassassin</p></td> |
681 |
</table> |
682 |
<!-- INDENTATION --> |
683 |
<table width="100%" border=0 rules="none" frame="void" |
684 |
@@ -4511,12 +4895,92 @@ |
685 |
<td width="78%"> |
686 |
<p>Default:</p> |
687 |
<!-- INDENTATION --> |
688 |
-<p>The site−local rules are searched for here, and in |
689 |
-prefix /etc/spamassassin, prefix/etc/mail/spamassassin, |
690 |
-/usr/local/etc/spamassassin, /etc/spamassassin, |
691 |
-/etc/mail/spamassassin, and maybe others. If this is set |
692 |
-then it adds to the list of places that are searched; |
693 |
-otherwise it has no effect.</p> |
694 |
+<p>This tells MailScanner where to look for the |
695 |
+site−local rules. If this is set it adds to the list |
696 |
+of places that are searched. MailScanner will always look at |
697 |
+the following places (even if this option is not set):</p> |
698 |
+</td> |
699 |
+</table> |
700 |
+<!-- TABS --> |
701 |
+<table width="100%" border=0 rules="none" frame="void" |
702 |
+ cols="5" cellspacing="0" cellpadding="0"> |
703 |
+<tr valign="top" align="left"> |
704 |
+<td width="22%"></td> |
705 |
+<td width="1%"> |
706 |
+ |
707 |
+<p>•</p> |
708 |
+</td> |
709 |
+<td width="5%"></td> |
710 |
+<td width="43%"> |
711 |
+ |
712 |
+<p>prefix/etc/spamassassin</p> |
713 |
+</td> |
714 |
+<td width="29%"> |
715 |
+</td> |
716 |
+<tr valign="top" align="left"> |
717 |
+<td width="22%"></td> |
718 |
+<td width="1%"> |
719 |
+ |
720 |
+<p>•</p> |
721 |
+</td> |
722 |
+<td width="5%"></td> |
723 |
+<td width="43%"> |
724 |
+ |
725 |
+<p>prefix/etc/mail/spamassassin</p> |
726 |
+</td> |
727 |
+<td width="29%"> |
728 |
+</td> |
729 |
+<tr valign="top" align="left"> |
730 |
+<td width="22%"></td> |
731 |
+<td width="1%"> |
732 |
+ |
733 |
+<p>•</p> |
734 |
+</td> |
735 |
+<td width="5%"></td> |
736 |
+<td width="43%"> |
737 |
+ |
738 |
+<p>/usr/local/etc/spamassassin</p> |
739 |
+</td> |
740 |
+<td width="29%"> |
741 |
+</td> |
742 |
+<tr valign="top" align="left"> |
743 |
+<td width="22%"></td> |
744 |
+<td width="1%"> |
745 |
+ |
746 |
+<p>•</p> |
747 |
+</td> |
748 |
+<td width="5%"></td> |
749 |
+<td width="43%"> |
750 |
+ |
751 |
+<p>/etc/spamassassin</p> |
752 |
+</td> |
753 |
+<td width="29%"> |
754 |
+</td> |
755 |
+<tr valign="top" align="left"> |
756 |
+<td width="22%"></td> |
757 |
+<td width="1%"> |
758 |
+ |
759 |
+<p>•</p> |
760 |
+</td> |
761 |
+<td width="5%"></td> |
762 |
+<td width="43%"> |
763 |
+ |
764 |
+<p>/etc/mail/spamassassin</p> |
765 |
+</td> |
766 |
+<td width="29%"> |
767 |
+</td> |
768 |
+<tr valign="top" align="left"> |
769 |
+<td width="22%"></td> |
770 |
+<td width="1%"> |
771 |
+ |
772 |
+<p>•</p> |
773 |
+</td> |
774 |
+<td width="5%"></td> |
775 |
+<td width="43%"> |
776 |
+ |
777 |
+<p>maybe others as well</p> |
778 |
+</td> |
779 |
+<td width="29%"> |
780 |
</td> |
781 |
</table> |
782 |
<!-- INDENTATION --> |
783 |
@@ -4533,13 +4997,73 @@ |
784 |
<tr valign="top" align="left"> |
785 |
<td width="22%"></td> |
786 |
<td width="78%"> |
787 |
-<p>Default:</p> |
788 |
+<p>Default:</p></td> |
789 |
+</table> |
790 |
<!-- INDENTATION --> |
791 |
-<p>The default rules are searched for here, and in |
792 |
-prefix/share/spamassassin, /usr/local/share/spamassassin, |
793 |
-/usr/share/spamassassin, and maybe others. If this is set |
794 |
-then it adds to the list of places that are searched; |
795 |
-otherwise it has no effect.</p> |
796 |
+<table width="100%" border=0 rules="none" frame="void" |
797 |
+ cols="2" cellspacing="0" cellpadding="0"> |
798 |
+<tr valign="top" align="left"> |
799 |
+<td width="28%"></td> |
800 |
+<td width="72%"> |
801 |
+<p>This tells MailScanner where to look for the default |
802 |
+rules. If this is set it adds to the list of places that are |
803 |
+searched. MailScanner will always look at the following |
804 |
+places (even if this option is not set):</p></td> |
805 |
+</table> |
806 |
+<!-- TABS --> |
807 |
+<table width="100%" border=0 rules="none" frame="void" |
808 |
+ cols="5" cellspacing="0" cellpadding="0"> |
809 |
+<tr valign="top" align="left"> |
810 |
+<td width="22%"></td> |
811 |
+<td width="1%"> |
812 |
+ |
813 |
+<p>•</p> |
814 |
+</td> |
815 |
+<td width="5%"></td> |
816 |
+<td width="44%"> |
817 |
+ |
818 |
+<p>prefix/share/spamassassin</p> |
819 |
+</td> |
820 |
+<td width="28%"> |
821 |
+</td> |
822 |
+<tr valign="top" align="left"> |
823 |
+<td width="22%"></td> |
824 |
+<td width="1%"> |
825 |
+ |
826 |
+<p>•</p> |
827 |
+</td> |
828 |
+<td width="5%"></td> |
829 |
+<td width="44%"> |
830 |
+ |
831 |
+<p>/usr/local/share/spamassassin</p> |
832 |
+</td> |
833 |
+<td width="28%"> |
834 |
+</td> |
835 |
+<tr valign="top" align="left"> |
836 |
+<td width="22%"></td> |
837 |
+<td width="1%"> |
838 |
+ |
839 |
+<p>•</p> |
840 |
+</td> |
841 |
+<td width="5%"></td> |
842 |
+<td width="44%"> |
843 |
+ |
844 |
+<p>/usr/share/spamassassin</p> |
845 |
+</td> |
846 |
+<td width="28%"> |
847 |
+</td> |
848 |
+<tr valign="top" align="left"> |
849 |
+<td width="22%"></td> |
850 |
+<td width="1%"> |
851 |
+ |
852 |
+<p>•</p> |
853 |
+</td> |
854 |
+<td width="5%"></td> |
855 |
+<td width="44%"> |
856 |
+ |
857 |
+<p>maybe others as well</p> |
858 |
+</td> |
859 |
+<td width="28%"> |
860 |
</td> |
861 |
</table> |
862 |
<a name="Advanced Settings"></a> |
863 |
@@ -4797,15 +5321,78 @@ |
864 |
<td width="78%"> |
865 |
<p>Default: supported</p> |
866 |
<!-- INDENTATION --> |
867 |
-<p>Some of the virus scanners are not supported by the |
868 |
-authors of MailScanner, and they may use code contributed by |
869 |
-another user. If this option is set to the wrong value for |
870 |
-your virus scanners, then you will get an error message in |
871 |
-your maillog (syslog) telling you tha# Are you using Exim |
872 |
-with split spool directories? If you don’t understand |
873 |
-# this, the answer is probably "no". Refer to the |
874 |
-Exim documentation for # more information about split spool |
875 |
-directories. Split Exim Spool = yes</p> |
876 |
+<p>Minimum acceptable code stability status −− |
877 |
+if we come across code that’s not at least as stable |
878 |
+as this, we barf. This is currently only used to check that |
879 |
+you don’t end up using untested virus scanner support |
880 |
+code without realising it. Don’t even *think* about |
881 |
+setting this to anything other than "beta" or |
882 |
+"supported" on a system that receives real mail |
883 |
+until you have tested it yourself and are happy that it is |
884 |
+all working as you expect it to. Don’t set it to |
885 |
+anything other than "supported" on a system that |
886 |
+could ever receive important mail. Levels used are:</p> |
887 |
+</td> |
888 |
+</table> |
889 |
+<!-- TABS --> |
890 |
+<table width="100%" border=0 rules="none" frame="void" |
891 |
+ cols="4" cellspacing="0" cellpadding="0"> |
892 |
+<tr valign="top" align="left"> |
893 |
+<td width="22%"></td> |
894 |
+<td width="1%"> |
895 |
+ |
896 |
+<p>•</p> |
897 |
+</td> |
898 |
+<td width="5%"></td> |
899 |
+<td width="72%"> |
900 |
+ |
901 |
+<p>none − there may not even be any code.</p> |
902 |
+</td> |
903 |
+<tr valign="top" align="left"> |
904 |
+<td width="22%"></td> |
905 |
+<td width="1%"> |
906 |
+ |
907 |
+<p>•</p> |
908 |
+</td> |
909 |
+<td width="5%"></td> |
910 |
+<td width="72%"> |
911 |
+ |
912 |
+<p>unsupported − code may be completely untested, a |
913 |
+contributed dirty hack, anything, really.</p> |
914 |
+</td> |
915 |
+<tr valign="top" align="left"> |
916 |
+<td width="22%"></td> |
917 |
+<td width="1%"> |
918 |
+ |
919 |
+<p>•</p> |
920 |
+</td> |
921 |
+<td width="5%"></td> |
922 |
+<td width="72%"> |
923 |
+ |
924 |
+<p>alpha − code is pretty well untested. Don’t |
925 |
+assume it will work.</p> |
926 |
+</td> |
927 |
+<tr valign="top" align="left"> |
928 |
+<td width="22%"></td> |
929 |
+<td width="1%"> |
930 |
+ |
931 |
+<p>•</p> |
932 |
+</td> |
933 |
+<td width="5%"></td> |
934 |
+<td width="72%"> |
935 |
+ |
936 |
+<p>beta − code is tested a bit. It should work.</p> |
937 |
+</td> |
938 |
+<tr valign="top" align="left"> |
939 |
+<td width="22%"></td> |
940 |
+<td width="1%"> |
941 |
+ |
942 |
+<p>•</p> |
943 |
+</td> |
944 |
+<td width="5%"></td> |
945 |
+<td width="72%"> |
946 |
+ |
947 |
+<p>supported − code *should* be reliable.</p> |
948 |
</td> |
949 |
</table> |
950 |
<!-- INDENTATION --> |
951 |
@@ -4822,8 +5409,14 @@ |
952 |
<tr valign="top" align="left"> |
953 |
<td width="22%"></td> |
954 |
<td width="78%"> |
955 |
-<p>Default: yes</p> |
956 |
+<p>Default: yes</p></td> |
957 |
+</table> |
958 |
<!-- INDENTATION --> |
959 |
+<table width="100%" border=0 rules="none" frame="void" |
960 |
+ cols="2" cellspacing="0" cellpadding="0"> |
961 |
+<tr valign="top" align="left"> |
962 |
+<td width="28%"></td> |
963 |
+<td width="72%"> |
964 |
<p>Are you using Exim with split spool directories? If you |
965 |
don’t understand this, the answer is probably |
966 |
"no". Refer to the Exim documentation for more |
967 |
@@ -4850,22 +5443,55 @@ |
968 |
<p>When trying to work out the value of configuration |
969 |
parameters which are using a ruleset, this controls the |
970 |
behaviour when a rule is checking the "To:" |
971 |
-addresses. If this option is set to "yes", then |
972 |
-the following happens when checking the ruleset:</p> |
973 |
-<!-- INDENTATION --> |
974 |
-<p>a) 1 recipient. Same behaviour as normal.<br> |
975 |
-b) Several recipients, but all in the same domain |
976 |
+addresses. If this option is set to "no", then |
977 |
+some rules will use the result they get from the first |
978 |
+matching rule for any of the recipients of a message, so the |
979 |
+exact value cannot be predicted for messages with more than |
980 |
+1 recipient. This value *cannot* be the filename of a |
981 |
+ruleset.<br> |
982 |
+If this option is set to "yes", then the following |
983 |
+happens when checking the ruleset:</p> |
984 |
+</td> |
985 |
+</table> |
986 |
+<!-- TABS --> |
987 |
+<table width="100%" border=0 rules="none" frame="void" |
988 |
+ cols="4" cellspacing="0" cellpadding="0"> |
989 |
+<tr valign="top" align="left"> |
990 |
+<td width="22%"></td> |
991 |
+<td width="3%"> |
992 |
+ |
993 |
+<p>a)</p> |
994 |
+</td> |
995 |
+<td width="3%"></td> |
996 |
+<td width="72%"> |
997 |
+ |
998 |
+<p>1 recipient. Same behaviour as normal.</p> |
999 |
+</td> |
1000 |
+<tr valign="top" align="left"> |
1001 |
+<td width="22%"></td> |
1002 |
+<td width="3%"> |
1003 |
+ |
1004 |
+<p>b)</p> |
1005 |
+</td> |
1006 |
+<td width="3%"></td> |
1007 |
+<td width="72%"> |
1008 |
+ |
1009 |
+<p>Several recipients, but all in the same domain |
1010 |
(domain.com for example). The rules are checked for one that |
1011 |
-matches the string "*@domain.com".<br> |
1012 |
-c) Several recipients, not all in the same domain. The rules |
1013 |
-are checked for one that matches the string |
1014 |
+matches the string "*@domain.com".</p> |
1015 |
+</td> |
1016 |
+<tr valign="top" align="left"> |
1017 |
+<td width="22%"></td> |
1018 |
+<td width="3%"> |
1019 |
+ |
1020 |
+<p>c)</p> |
1021 |
+</td> |
1022 |
+<td width="3%"></td> |
1023 |
+<td width="72%"> |
1024 |
+ |
1025 |
+<p>Several recipients, not all in the same domain. The |
1026 |
+rules are checked for one that matches the string |
1027 |
"*@*".</p> |
1028 |
-<!-- INDENTATION --> |
1029 |
-<p>If this option is set to "no", then some rules |
1030 |
-will use the result they get from the first matching rule |
1031 |
-for any of the recipients of a message, so the exact value |
1032 |
-cannot be predicted for messages with more than 1 recipient. |
1033 |
-This value *cannot* be the filename of a ruleset.</p> |
1034 |
</td> |
1035 |
</table> |
1036 |
<a name="RULESETS"></a> |