View | Details | Raw Unified | Return to bug 83139
Collapse All | Expand All

(-)Makefile (-1 / +1 lines)
Lines 6-12 Link Here
6
#
6
#
7
7
8
PORTNAME=	MailScanner
8
PORTNAME=	MailScanner
9
PORTVERSION=	4.42.9
9
PORTVERSION=	4.43.8
10
PORTREVISION=	1
10
PORTREVISION=	1
11
CATEGORIES=	mail
11
CATEGORIES=	mail
12
MASTER_SITES=	http://www.sng.ecs.soton.ac.uk/mailscanner/files/4/tar/
12
MASTER_SITES=	http://www.sng.ecs.soton.ac.uk/mailscanner/files/4/tar/
(-)distinfo (-2 / +2 lines)
Lines 1-2 Link Here
1
MD5 (MailScanner-install-4.42.9-1.tar.gz) = 893eda4833586b61b5b78af95d0f2f0d
1
MD5 (MailScanner-install-4.43.8-1.tar.gz) = 274cab190e703851716a3bd4d3d7f58f
2
SIZE (MailScanner-install-4.42.9-1.tar.gz) = 4775108
2
SIZE (MailScanner-install-4.43.8-1.tar.gz) = 4791190
(-)pkg-plist (+5 lines)
Lines 18-28 Link Here
18
lib/MailScanner/MailScanner/Config.pm
18
lib/MailScanner/MailScanner/Config.pm
19
lib/MailScanner/MailScanner/ConfigDefs.pl
19
lib/MailScanner/MailScanner/ConfigDefs.pl
20
lib/MailScanner/MailScanner/CustomConfig.pm
20
lib/MailScanner/MailScanner/CustomConfig.pm
21
lib/MailScanner/MailScanner/CustomFunctions/GenericSpamScanner.pm
21
lib/MailScanner/MailScanner/CustomFunctions/MyExample.pm
22
lib/MailScanner/MailScanner/CustomFunctions/MyExample.pm
22
lib/MailScanner/MailScanner/CustomFunctions/DavidHooton.pm
23
lib/MailScanner/MailScanner/CustomFunctions/DavidHooton.pm
23
lib/MailScanner/MailScanner/CustomFunctions/ZMRouterDirHash.pm
24
lib/MailScanner/MailScanner/CustomFunctions/ZMRouterDirHash.pm
24
lib/MailScanner/MailScanner/Exim.pm
25
lib/MailScanner/MailScanner/Exim.pm
25
lib/MailScanner/MailScanner/EximDiskStore.pm
26
lib/MailScanner/MailScanner/EximDiskStore.pm
27
lib/MailScanner/MailScanner/GenericSpam.pm
26
lib/MailScanner/MailScanner/Lock.pm
28
lib/MailScanner/MailScanner/Lock.pm
27
lib/MailScanner/MailScanner/Log.pm
29
lib/MailScanner/MailScanner/Log.pm
28
lib/MailScanner/MailScanner/MCP.pm
30
lib/MailScanner/MailScanner/MCP.pm
Lines 492-503 Link Here
492
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.2.61
494
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.2.61
493
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.2.63
495
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.2.63
494
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.3.0.0
496
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.3.0.0
497
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Conf.pm.patch.3.0.3
495
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Message.pm.patch.3.0.0
498
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Message.pm.patch.3.0.0
499
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/Message.pm.patch.3.0.3
496
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.55
500
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.55
497
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.60
501
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.60
498
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.61
502
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.61
499
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.63
503
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.2.63
500
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.3.0.0
504
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.3.0.0
505
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/PerMsgStatus.pm.patch.3.0.3
501
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/index.html
506
%%PORTDOCS%%%%DOCSDIR%%/install/mcp/index.html
502
%%PORTDOCS%%@exec mkdir -p %D/%%DOCSDIR%%/install/tcp
507
%%PORTDOCS%%@exec mkdir -p %D/%%DOCSDIR%%/install/tcp
503
%%PORTDOCS%%%%DOCSDIR%%/install/mime-tools-patch.txt
508
%%PORTDOCS%%%%DOCSDIR%%/install/mime-tools-patch.txt
(-)files/patch-docs:man:MailScanner.8 (-4 / +4 lines)
Lines 1-8 Link Here
1
--- ../MailScanner-install-4.42.9.orig/docs/man/MailScanner.8	Wed Jun  1 11:24:25 2005
1
--- ../MailScanner-install-4.43.8.orig/docs/man/MailScanner.8	Fri Jul  8 14:17:05 2005
2
+++ docs/man/MailScanner.8	Wed Jun  1 11:30:08 2005
2
+++ docs/man/MailScanner.8	Fri Jul  8 14:17:28 2005
3
@@ -1,4 +1,4 @@
3
@@ -1,4 +1,4 @@
4
-.TH "MailScanner" "8" "4.38.2" "Julian Field" "Mail"
4
-.TH "MailScanner" "8" "4.42.9" "Julian Field" "Mail"
5
+.TH "MailScanner" "8" "4.42.9" "Julian Field" "Mail"
5
+.TH "MailScanner" "8" "4.43.8" "Julian Field" "Mail"
6
 .SH "NAME"
6
 .SH "NAME"
7
 .LP 
7
 .LP 
8
 MailScanner \- Virus/Spam Scanner for Sendmail, Exim and Postfix
8
 MailScanner \- Virus/Spam Scanner for Sendmail, Exim and Postfix
(-)files/patch-docs:man:MailScanner.8.html (-4 / +4 lines)
Lines 1-9 Link Here
1
--- ../MailScanner-install-4.42.9.orig/docs/man/MailScanner.8.html	Wed Jun  1 11:24:25 2005
1
--- ../MailScanner-install-4.43.8.orig/docs/man/MailScanner.8.html	Fri Jul  8 14:17:05 2005
2
+++ docs/man/MailScanner.8.html	Wed Jun  1 11:30:10 2005
2
+++ docs/man/MailScanner.8.html	Fri Jul  8 14:17:30 2005
3
@@ -1,5 +1,5 @@
3
@@ -1,5 +1,5 @@
4
 <!-- Creator     : groff version 1.19 -->
4
 <!-- Creator     : groff version 1.19 -->
5
-<!-- CreationDate: Mon Jan 17 15:53:41 2005 -->
5
-<!-- CreationDate: Wed Jun  1 11:29:47 2005 -->
6
+<!-- CreationDate: Wed Jun  1 11:29:47 2005 -->
6
+<!-- CreationDate: Fri Jul  8 14:16:24 2005 -->
7
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
7
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
8
 "http://www.w3.org/TR/html4/loose.dtd">
8
 "http://www.w3.org/TR/html4/loose.dtd">
9
 <html>
9
 <html>
(-)files/patch-docs:man:MailScanner.conf.5 (-139 / +39 lines)
Lines 1-177 Link Here
1
--- ../MailScanner-install-4.42.9.orig/docs/man/MailScanner.conf.5	Wed Jun  1 11:24:25 2005
1
--- ../MailScanner-install-4.43.8.orig/docs/man/MailScanner.conf.5	Fri Jul  8 14:17:05 2005
2
+++ docs/man/MailScanner.conf.5	Wed Jun  1 11:30:13 2005
2
+++ docs/man/MailScanner.conf.5	Fri Jul  8 14:17:23 2005
3
@@ -1,4 +1,4 @@
3
@@ -1,4 +1,4 @@
4
-.TH "MailScanner.conf" "5" "4.38.2" "Julian Field" "Mail"
4
-.TH "MailScanner.conf" "5" "4.42.9" "Julian Field" "Mail"
5
+.TH "MailScanner.conf" "5" "4.42.9" "Julian Field" "Mail"
5
+.TH "MailScanner.conf" "5" "4.43.8" "Julian Field" "Mail"
6
 .SH "NAME"
6
 .SH "NAME"
7
 .LP 
7
 .LP 
8
 MailScanner.conf \- Main configuration for MailScanner
8
 MailScanner.conf \- Main configuration for MailScanner
9
@@ -27,7 +27,9 @@
9
@@ -1701,12 +1701,64 @@
10
 Many of the options can also be the filename of a ruleset, which can be used to control features depending on the addresses of the message, and/or the IP address where the message came from. You will find some examples of rulesets and an explanation of them in the "rules" directories within the MailScanner installation and in the section "RULESETS" later in this manpage.
11
 
12
 .LP 
13
-The options are best listed in a few categories. This is also the order in which you will find them in the MailScanner.conf file. If this list looks very large then don't worry, the supplied MailScanner.conf file (or MailScanner.conf.sample) contains sensible defaults for all the values. You will probably only need to change a very few of them to start with.
14
+The options are best listed in a few categories. If this list looks very large then don't worry, the supplied MailScanner.conf file (or MailScanner.conf.sample) contains sensible defaults for all the values. You will probably only need to change a very few of them to start with.
15
+
16
+Starting with version 4.40.10 of MailScanner you can use shell environment variables such as $HOSTNAME or ${HOSTNAME} in MailScanner.conf and its relatives.
17
 
18
 .LP 
19
 You should define the following variables:
20
@@ -74,6 +76,22 @@
21
 Enter a short identifying name for your organisation below, this is used to make the X\-MailScanner headers unique for your organisation. Multiple servers within one site should use an identical value here to avoid adding multiple redundant headers where mail has passed through several servers within your organisation. 
22
 .br 
10
 .br 
23
 Note: Some Symantec scanners complain (incorrectly) about "." characters appearing in the names of headers.
11
 
24
+
25
+.TP 
26
+\fB%org\-long\-name%\fR
27
+Default: Your Organisation Name Here
28
+.br 
29
+
30
+.br 
31
+Enter the full name of your organisation below, this is used in the signature placed at the bottom of report messages sent by MailScanner. It can include pretty much any text you like. You can make the result span several lines by including "\n" sequences in the text. These will be replaced by line\-breaks.
32
+
33
+.TP 
34
+\fB%web\-site%\fR
35
+Default: www.your\-organisation.com
36
+.br 
37
+
38
+.br 
39
+Enter the location of your organisation's web site below. This is used in the signature placed at the bottom of report messages sent by MailScanner. It should preferably be the location of a page that you have written explaining why you might have rejected the mail and what the recipient and/or sender should do about it.
40
 .SH "System Settings"
41
 .TP 
42
 \fBMax Children\fR
43
@@ -370,6 +388,23 @@
44
 .br 
12
 .br 
45
 The maximum length of time the "file" command is allowed to run for one batch of messages (in seconds).
13
-# The Bayesian database rebuild and expiry may take a 2 or 3 minutes
14
-# to complete. During this time you can either wait, or simply
15
-# disable SpamAssassin checks until it has completed.
16
-WaitDuringBayesRebuild = no
17
+The Bayesian database rebuild and expiry may take a 2 or 3 minutes to complete. During this time you can either wait, or simply disable SpamAssassin checks until it has completed.
46
 
18
 
47
+
48
+.TP 
49
+\fBUnrar Command\fR
50
+Default: /usr/bin/unrar
51
+.br 
52
+
53
+.br 
54
+Where the "unrar" command is installed. If you haven't got this command, look at www.rarlab.com. This is used for unpacking rar archives so that the contents can be checked for banned filenames and filetypes, and also that the archive can be tested to see if it is password\-protected. Virus scanning the contents of rar archives is still left to the virus scanner, with one exception: If using the clavavmodule virus scanner, this adds external RAR checking to that scanner which is needed for archives which are RAR version 3.
55
+
56
+.TP 
57
+\fBUnrar Timeout\fR
58
+Default: 50
59
+.br 
60
+
61
+.br 
62
+The maximum length of time the "unrar" command is allowed to run for 1 RAR archive (in seconds)
63
+
64
 .TP 
65
 \fBBlock Encrypted Messages\fR
66
 Default: no
67
@@ -562,6 +597,41 @@
68
 
19
 
69
 .br 
70
 ClamAVModule only: monitor each of these files for changes in size to detect when a ClamAV update has happened. This is only used by the "clamavmodule" virus scanner, not the "clamav" scanner setting.
71
+
20
+
21
+.SH "Custom Spam Scanner Plugin"
72
+.TP 
22
+.TP 
73
+\fBClamAVmodule Maximum Recursion Level\fR
23
+\fBUse Custom Spam Scanner\fR
74
+Default: 5
24
+Default: no
75
+.br 
25
+.br 
76
+
26
+
77
+.br 
27
+.br 
78
+ClamAVModule only: The maximum recursion level of archives. This setting *cannot* be the filename of a ruleset, only a simple number.
28
+Use the Custom Spam Scanner. This is code you will have to write yourself, a function called "GenericSpamScanner" stored in the file "MailScanner/lib/MailScanner/CustomFunctions/GenericSpamScanner.pm". A sample function is given in the correct file in the distribution. This sample function also includes code to show you how to make it run an external program to produce a spam score. This can also be the filename of a ruleset. The function will be passed
79
+
80
+.TP 
81
+\fBClamAVmodule Maximum Files\fR
82
+Default: 100
83
+.br 
29
+.br 
84
+
30
+.RS 7
31
+.IP  \(bu 4
32
+$IP		\- the numeric IP address of the system on the remote end of the SMTP connections
33
+.IP  \(bu 4
34
+$From	\- the address of the envelope sender of the message
35
+.IP  \(bu 4
36
+$To		\- a perl reference to the envelope recipients of the message
37
+.IP  \(bu 4
38
+$Message	\- a perl reference to the list of line of the message
39
+.RE
85
+.br 
40
+.br 
86
+ClamAVModule only: The maximum number of files per batch. This setting *cannot* be the filename of a ruleset, only a simple number.
87
+
41
+
88
+
42
+
89
+.TP 
43
+.TP 
90
+\fBClamAVmodule Maximum File Size\fR
44
+\fBMax Custom Spam Scanner Size\fR
91
+Default: 10000000
45
+Default: 20000
92
+.br 
46
+.br 
93
+
47
+
94
+.br 
48
+.br 
95
+ClamAVModule only: The maximum file of each file (Default = 10MB). This setting *cannot* be the filename of a ruleset, only a simple number.
49
+How much of the message should be passed tot he Custom Spam Scanner. Most spam tools only need the first 20kbytes of the message to determine if it is spam or not. Passing more than is necessary only slows things down. This can also be the filename of a ruleset.
96
+
97
+
50
+
98
+.TP 
51
+.TP 
99
+\fB\fRClamAVmodule Maximum Compression Ratio
52
+\fBCustom Spam Scanner Timeout\fR
100
+Default: 250
53
+Default: 20
101
+.br 
102
+
103
+.br 
104
+ClamAVModule only: The maximum compression ration of archives. This setting *cannot* be the filename of a ruleset, only a simple number.
105
+ 
106
 .SH "Removing/Logging dangerous or potentially offensive content"
107
 .TP 
108
 \fBAllow Partial Messages\fR
109
@@ -601,6 +671,15 @@
110
 
111
 
112
 .TP 
113
+\fBPhishing Safe Sites File\fR
114
+Default: %etc\-dir%/phishing.safe.sites.conf
115
+.br 
54
+.br 
116
+
55
+
117
+.br 
56
+.br 
118
+There are some companies, such as banks, that insist on sending out email messages with links in them that are caught by the "Find Phishing Fraud" test described above. This is the name of a file which contains a list of link destinations which should be ignored in the test. This may, for example, contain the known websites of some banks. See the file itself for more information. This can only be the name of the file containing the list, it *cannot* be the filename of a ruleset.
57
+How long should the custom spam scanner take to run? If it takes more seconds than this, then it should be considered to have crashed and should be killed. This stops denial\-of\-service attacks.
119
+
58
+
120
+
59
+
121
+.TP 
60
+.TP 
122
 \fBAllow IFrame Tags\fR
61
+\fBMax Custom Spam Scanner Timeouts\fR
123
 Default: no
62
+Default: 10
124
 .br 
125
@@ -1233,6 +1312,23 @@
126
 .br 
127
 This is the text inserted at the start of the "Subject:" line if the "Content Modify Subject" option is set. 
128
 
129
+.TP 
130
+\fBDisarmed Modify Subject\fR
131
+Default: yes
132
+.br 
63
+.br 
133
+
64
+
134
+.br 
65
+.br 
135
+If HTML tags in the message were "disarmed" by using the HTML "Allow" options above with the "disarm" settings, do you want to modify the subject line? This can also be the filename of a ruleset.
66
+If the Custom Spam Scanner times out more times in a row than this, then it will be marked as "unavailable" until MailScanner next re\-starts itself.
136
+
137
+
67
+
138
+.TP 
68
+.TP 
139
+\fBDisarmed Subject Text\fR
69
+\fBCustom Spam Scanner Timeout History\fR
140
+Default: {Disarmed}
70
+Default: 20
141
+.br 
71
+.br 
142
+
72
+
143
+.br 
73
+.br 
144
+This is the text to add to the start of the subject if the "Disarmed Modify Subject" option is set. This can also be the filename of a ruleset.
74
+The total number of Custom Spam Scanner attempts during which "Max Custom Spam Scanner Timeouts" will cause the Custom Spam Scanner to be marked as "unavailable". See the previous comment for more information. The default values of 10 and 20 mean that 10 timeouts in any sequence of 20 attempts will trigger the behaviour described above, until the next periodic restart (see "Restart Every").
145
+
75
 .SH "What to do with spam"
146
 
147
 .TP 
76
 .TP 
148
 \fBSpam Modify Subject\fR
77
 \fBSpam Actions\fR
149
@@ -1415,6 +1511,15 @@
150
 This provides a space\-separated list of "Spam Lists" (or RBL's or DNSBL's) which are checked for each message. These lists are based on the domain name of the sender address of each message. Every list used here must be defined in the "Spam List Definitions" file mentioned above. 
151
 
152
 .TP 
153
+\fBSpam Lists To Be Spam\fR
154
+Default: 1
155
+.br 
156
+
157
+.br 
158
+If a message appears in at least this number of "Spam Lists" (as defined above), then the message will be treated as spam and so the "Spam Actions" will happen, unless the message reaches the levels for "High Scoring Spam". By default this is set to 1 to mimic the previous behaviour, which means that appearing in any "Spam Lists" will cause the message to be treated as spam. This can also be the filename of a ruleset.
159
+
160
+
161
+.TP 
162
 \fBSpam Lists To Reach High Score\fR
163
 Default: 5
164
 .br 
165
@@ -1753,6 +1858,12 @@
166
 
167
 .br 
168
 Log all occurrences of "Silent Viruses" as defined above? This can only be a simple yes/no value, not a ruleset.
169
+
170
+.TP 
171
+\fBLog Dangerous HTML Tags\fR
172
+Default: no
173
+.br 
174
+Log all occurrences of HTML tags found in messages, that can be blocked. This will help you build up your whitelist of message sources for which particular HTML tags should be allowed, such as mail from newsletters and daily cartoon strips. This can also be the filename of a ruleset.
175
 .SH "Advanced SpamAssassin Settings"
176
 If you are using Postfix you may well need to use some of the settings below, as the home directory for the "postfix" user cannot be written to by the "postfix" user. You may also need to use these if you have installed SpamAssassin somewhere other than the default location. 
177
 
(-)files/patch-docs:man:MailScanner.conf.5.html (-261 / +141 lines)
Lines 1-70 Link Here
1
--- ../MailScanner-install-4.42.9.orig/docs/man/MailScanner.conf.5.html	Wed Jun  1 11:24:25 2005
1
--- ../MailScanner-install-4.43.8.orig/docs/man/MailScanner.conf.5.html	Fri Jul  8 14:17:05 2005
2
+++ docs/man/MailScanner.conf.5.html	Wed Jun  1 11:30:17 2005
2
+++ docs/man/MailScanner.conf.5.html	Fri Jul  8 14:17:25 2005
3
@@ -1,5 +1,5 @@
3
@@ -1,5 +1,5 @@
4
 <!-- Creator     : groff version 1.19 -->
4
 <!-- Creator     : groff version 1.19 -->
5
-<!-- CreationDate: Mon Jan 17 15:53:41 2005 -->
5
-<!-- CreationDate: Wed Jun  1 11:29:47 2005 -->
6
+<!-- CreationDate: Wed Jun  1 11:29:47 2005 -->
6
+<!-- CreationDate: Fri Jul  8 14:16:24 2005 -->
7
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
7
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
8
 "http://www.w3.org/TR/html4/loose.dtd">
8
 "http://www.w3.org/TR/html4/loose.dtd">
9
 <html>
9
 <html>
10
@@ -120,13 +120,15 @@
10
@@ -34,6 +34,7 @@
11
 directories within the MailScanner installation and in the
11
 <a href="#Definitions of virus scanners and spam detectors">Definitions of virus scanners and spam detectors</a><br>
12
 section &quot;RULESETS&quot; later in this manpage.</p>
12
 <a href="#Spam detection and spam lists (DNS blocklists)">Spam detection and spam lists (DNS blocklists)</a><br>
13
 <a href="#SpamAssassin">SpamAssassin</a><br>
14
+<a href="#Custom Spam Scanner Plugin">Custom Spam Scanner Plugin</a><br>
15
 <a href="#What to do with spam">What to do with spam</a><br>
16
 <a href="#System logging">System logging</a><br>
17
 <a href="#Advanced SpamAssassin Settings">Advanced SpamAssassin Settings</a><br>
18
@@ -4909,10 +4910,239 @@
19
 <td width="78%">
20
 <p>Default: no</p>
13
 <!-- INDENTATION -->
21
 <!-- INDENTATION -->
14
-<p>The options are best listed in a few categories. This is
22
-<p># The Bayesian database rebuild and expiry may take a 2
15
-also the order in which you will find them in the
23
-or 3 minutes # to complete. During this time you can either
16
-MailScanner.conf file. If this list looks very large then
24
-wait, or simply # disable SpamAssassin checks until it has
17
-don&rsquo;t worry, the supplied MailScanner.conf file (or
25
-completed. WaitDuringBayesRebuild = no</p>
18
-MailScanner.conf.sample) contains sensible defaults for all
26
+<p>The Bayesian database rebuild and expiry may take a 2 or
19
-the values. You will probably only need to change a very few
27
+3 minutes to complete. During this time you can either wait,
20
-of them to start with.</p>
28
+or simply disable SpamAssassin checks until it has
21
+<p>The options are best listed in a few categories. If this
29
+completed.</p>
22
+list looks very large then don&rsquo;t worry, the supplied
23
+MailScanner.conf file (or MailScanner.conf.sample) contains
24
+sensible defaults for all the values. You will probably only
25
+need to change a very few of them to start with.</p>
26
+<!-- INDENTATION -->
27
+<p>Starting with version 4.40.10 of MailScanner you can use
28
+shell environment variables such as $HOSTNAME or ${HOSTNAME}
29
+in MailScanner.conf and its relatives.</p>
30
 <!-- INDENTATION -->
31
 <p>You should define the following variables:</p>
32
 </td>
33
@@ -220,6 +222,54 @@
34
 headers.</p>
35
 </td>
36
 </table>
37
+<!-- INDENTATION -->
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="11%"></td>
42
+<td width="89%">
43
+<p><b>%org&minus;long&minus;name%</b></p></td>
44
+</table>
45
+<!-- INDENTATION -->
46
+<table width="100%" border=0 rules="none" frame="void"
47
+       cols="2" cellspacing="0" cellpadding="0">
48
+<tr valign="top" align="left">
49
+<td width="22%"></td>
50
+<td width="78%">
51
+<p>Default: Your Organisation Name Here</p>
52
+<!-- INDENTATION -->
53
+<p>Enter the full name of your organisation below, this is
54
+used in the signature placed at the bottom of report
55
+messages sent by MailScanner. It can include pretty much any
56
+text you like. You can make the result span several lines by
57
+including &quot;0 sequences in the text. These will be
58
+replaced by line&minus;breaks.</p>
59
+</td>
30
+</td>
60
+</table>
31
+</table>
32
+<a name="Custom Spam Scanner Plugin"></a>
33
+<h2>Custom Spam Scanner Plugin</h2>
61
+<!-- INDENTATION -->
34
+<!-- INDENTATION -->
62
+<table width="100%" border=0 rules="none" frame="void"
35
+<table width="100%" border=0 rules="none" frame="void"
63
+       cols="2" cellspacing="0" cellpadding="0">
36
+       cols="2" cellspacing="0" cellpadding="0">
64
+<tr valign="top" align="left">
37
+<tr valign="top" align="left">
65
+<td width="11%"></td>
38
+<td width="11%"></td>
66
+<td width="89%">
39
+<td width="89%">
67
+<p><b>%web&minus;site%</b></p></td>
40
+<p><b>Use Custom Spam Scanner</b></p></td>
68
+</table>
41
+</table>
69
+<!-- INDENTATION -->
42
+<!-- INDENTATION -->
70
+<table width="100%" border=0 rules="none" frame="void"
43
+<table width="100%" border=0 rules="none" frame="void"
Lines 72-241 Link Here
72
+<tr valign="top" align="left">
45
+<tr valign="top" align="left">
73
+<td width="22%"></td>
46
+<td width="22%"></td>
74
+<td width="78%">
47
+<td width="78%">
75
+<p>Default: www.your&minus;organisation.com</p>
48
+<p>Default: no</p>
76
+<!-- INDENTATION -->
49
+<!-- INDENTATION -->
77
+<p>Enter the location of your organisation&rsquo;s web site
50
+<p>Use the Custom Spam Scanner. This is code you will have
78
+below. This is used in the signature placed at the bottom of
51
+to write yourself, a function called
79
+report messages sent by MailScanner. It should preferably be
52
+&quot;GenericSpamScanner&quot; stored in the file
80
+the location of a page that you have written explaining why
53
+&quot;MailScanner/lib/MailScanner/CustomFunctions/GenericSpamScanner.pm&quot;.
81
+you might have rejected the mail and what the recipient
54
+A sample function is given in the correct file in the
82
+and/or sender should do about it.</p>
55
+distribution. This sample function also includes code to
56
+show you how to make it run an external program to produce a
57
+spam score. This can also be the filename of a ruleset. The
58
+function will be passed</p>
83
+</td>
59
+</td>
84
+</table>
60
+</table>
85
 <a name="System Settings"></a>
61
+<!-- TABS -->
86
 <h2>System Settings</h2>
87
 <!-- INDENTATION -->
88
@@ -1071,6 +1121,54 @@
89
 <tr valign="top" align="left">
90
 <td width="11%"></td>
91
 <td width="89%">
92
+<p><b>Unrar Command</b></p></td>
93
+</table>
94
+<!-- INDENTATION -->
95
+<table width="100%" border=0 rules="none" frame="void"
62
+<table width="100%" border=0 rules="none" frame="void"
96
+       cols="2" cellspacing="0" cellpadding="0">
63
+       cols="5" cellspacing="0" cellpadding="0">
97
+<tr valign="top" align="left">
64
+<tr valign="top" align="left">
98
+<td width="22%"></td>
65
+<td width="22%"></td>
99
+<td width="78%">
66
+<td width="1%">
100
+<p>Default: /usr/bin/unrar</p>
67
+
101
+<!-- INDENTATION -->
68
+<p>&bull;</p>
102
+<p>Where the &quot;unrar&quot; command is installed. If you
69
+</td>
103
+haven&rsquo;t got this command, look at www.rarlab.com. This
70
+<td width="5%"></td>
104
+is used for unpacking rar archives so that the contents can
71
+<td width="4%">
105
+be checked for banned filenames and filetypes, and also that
72
+
106
+the archive can be tested to see if it is
73
+<p>$IP</p>
107
+password&minus;protected. Virus scanning the contents of rar
74
+</td>
108
+archives is still left to the virus scanner, with one
75
+<td width="68%">
109
+exception: If using the clavavmodule virus scanner, this
110
+adds external RAR checking to that scanner which is needed
111
+for archives which are RAR version 3.</p>
112
+</td>
76
+</td>
113
+</table>
114
+<!-- INDENTATION -->
115
+<table width="100%" border=0 rules="none" frame="void"
116
+       cols="2" cellspacing="0" cellpadding="0">
117
+<tr valign="top" align="left">
118
+<td width="11%"></td>
119
+<td width="89%">
120
+<p><b>Unrar Timeout</b></p></td>
121
+</table>
122
+<!-- INDENTATION -->
123
+<table width="100%" border=0 rules="none" frame="void"
124
+       cols="2" cellspacing="0" cellpadding="0">
125
+<tr valign="top" align="left">
77
+<tr valign="top" align="left">
126
+<td width="22%"></td>
78
+<td width="22%"></td>
127
+<td width="78%">
79
+<td width="1%"></td>
128
+<p>Default: 50</p>
80
+<td width="5%"></td>
129
+<!-- INDENTATION -->
81
+<td width="4%">
130
+<p>The maximum length of time the &quot;unrar&quot; command
82
+</td>
131
+is allowed to run for 1 RAR archive (in seconds)</p>
83
+<td width="68%">
84
+
85
+<p>&minus; the numeric IP address of the system on the
86
+remote end of the SMTP connections</p>
132
+</td>
87
+</td>
133
+</table>
88
+</table>
134
+<!-- INDENTATION -->
89
+<!-- TABS -->
135
+<table width="100%" border=0 rules="none" frame="void"
136
+       cols="2" cellspacing="0" cellpadding="0">
137
+<tr valign="top" align="left">
138
+<td width="11%"></td>
139
+<td width="89%">
140
 <p><b>Block Encrypted Messages</b></p></td>
141
 </table>
142
 <!-- INDENTATION -->
143
@@ -1638,6 +1736,90 @@
144
 scanner, not the &quot;clamav&quot; scanner setting.</p>
145
 </td>
146
 </table>
147
+<!-- INDENTATION -->
148
+<table width="100%" border=0 rules="none" frame="void"
149
+       cols="2" cellspacing="0" cellpadding="0">
150
+<tr valign="top" align="left">
151
+<td width="11%"></td>
152
+<td width="89%">
153
+<p><b>ClamAVmodule Maximum Recursion Level</b></p></td>
154
+</table>
155
+<!-- INDENTATION -->
156
+<table width="100%" border=0 rules="none" frame="void"
90
+<table width="100%" border=0 rules="none" frame="void"
157
+       cols="2" cellspacing="0" cellpadding="0">
91
+       cols="7" cellspacing="0" cellpadding="0">
158
+<tr valign="top" align="left">
92
+<tr valign="top" align="left">
159
+<td width="22%"></td>
93
+<td width="22%"></td>
160
+<td width="78%">
94
+<td width="1%">
161
+<p>Default: 5</p>
95
+
162
+<!-- INDENTATION -->
96
+<p>&bull;</p>
163
+<p>ClamAVModule only: The maximum recursion level of
97
+</td>
164
+archives. This setting *cannot* be the filename of a
98
+<td width="5%"></td>
165
+ruleset, only a simple number.</p>
99
+<td width="7%">
100
+
101
+<p>$From</p>
102
+</td>
103
+<td width="2%"></td>
104
+<td width="8%">
105
+
106
+<p>&minus; the address of the envelope sender of the
107
+message</p>
108
+</td>
109
+<td width="55%">
166
+</td>
110
+</td>
167
+</table>
111
+</table>
168
+<!-- INDENTATION -->
112
+<!-- TABS -->
169
+<table width="100%" border=0 rules="none" frame="void"
170
+       cols="2" cellspacing="0" cellpadding="0">
171
+<tr valign="top" align="left">
172
+<td width="11%"></td>
173
+<td width="89%">
174
+<p><b>ClamAVmodule Maximum Files</b></p></td>
175
+</table>
176
+<!-- INDENTATION -->
177
+<table width="100%" border=0 rules="none" frame="void"
113
+<table width="100%" border=0 rules="none" frame="void"
178
+       cols="2" cellspacing="0" cellpadding="0">
114
+       cols="6" cellspacing="0" cellpadding="0">
179
+<tr valign="top" align="left">
115
+<tr valign="top" align="left">
180
+<td width="22%"></td>
116
+<td width="22%"></td>
181
+<td width="78%">
117
+<td width="1%">
182
+<p>Default: 100</p>
118
+
183
+<!-- INDENTATION -->
119
+<p>&bull;</p>
184
+<p>ClamAVModule only: The maximum number of files per batch.
120
+</td>
185
+This setting *cannot* be the filename of a ruleset, only a
121
+<td width="5%"></td>
186
+simple number.</p>
122
+<td width="9%">
123
+
124
+<p>$To</p>
125
+</td>
126
+<td width="8%"></td>
127
+<td width="55%">
187
+</td>
128
+</td>
188
+</table>
189
+<!-- INDENTATION -->
190
+<table width="100%" border=0 rules="none" frame="void"
191
+       cols="2" cellspacing="0" cellpadding="0">
192
+<tr valign="top" align="left">
193
+<td width="11%"></td>
194
+<td width="89%">
195
+<p><b>ClamAVmodule Maximum File Size</b></p></td>
196
+</table>
197
+<!-- INDENTATION -->
198
+<table width="100%" border=0 rules="none" frame="void"
199
+       cols="2" cellspacing="0" cellpadding="0">
200
+<tr valign="top" align="left">
129
+<tr valign="top" align="left">
201
+<td width="22%"></td>
130
+<td width="22%"></td>
202
+<td width="78%">
131
+<td width="1%"></td>
203
+<p>Default: 10000000</p>
132
+<td width="5%"></td>
204
+<!-- INDENTATION -->
133
+<td width="9%">
205
+<p>ClamAVModule only: The maximum file of each file (Default
134
+</td>
206
+= 10MB). This setting *cannot* be the filename of a ruleset,
135
+<td width="8%">
207
+only a simple number.</p>
136
+
137
+<p>&minus; a perl reference to the envelope recipients of
138
+the message</p>
139
+</td>
140
+<td width="55%">
208
+</td>
141
+</td>
209
+</table>
142
+</table>
210
+<!-- INDENTATION -->
143
+<!-- TABS -->
211
+<table width="100%" border=0 rules="none" frame="void"
212
+       cols="2" cellspacing="0" cellpadding="0">
213
+<tr valign="top" align="left">
214
+<td width="11%"></td>
215
+<td width="89%">
216
+<p>ClamAVmodule Maximum Compression Ratio</p></td>
217
+</table>
218
+<!-- INDENTATION -->
219
+<table width="100%" border=0 rules="none" frame="void"
144
+<table width="100%" border=0 rules="none" frame="void"
220
+       cols="2" cellspacing="0" cellpadding="0">
145
+       cols="5" cellspacing="0" cellpadding="0">
221
+<tr valign="top" align="left">
146
+<tr valign="top" align="left">
222
+<td width="22%"></td>
147
+<td width="22%"></td>
223
+<td width="78%">
148
+<td width="1%">
224
+<p>Default: 250</p>
149
+
225
+<!-- INDENTATION -->
150
+<p>&bull;</p>
226
+<p>ClamAVModule only: The maximum compression ration of
151
+</td>
227
+archives. This setting *cannot* be the filename of a
152
+<td width="5%"></td>
228
+ruleset, only a simple number.</p>
153
+<td width="12%">
154
+
155
+<p>$Message</p>
156
+</td>
157
+<td width="60%">
229
+</td>
158
+</td>
230
+</table>
231
 <a name="Removing/Logging dangerous or potentially offensive content"></a>
232
 <h2>Removing/Logging dangerous or potentially offensive content</h2>
233
 <!-- INDENTATION -->
234
@@ -1761,6 +1943,33 @@
235
 <tr valign="top" align="left">
236
 <td width="11%"></td>
237
 <td width="89%">
238
+<p><b>Phishing Safe Sites File</b></p></td>
239
+</table>
159
+</table>
240
+<!-- INDENTATION -->
160
+<!-- INDENTATION -->
241
+<table width="100%" border=0 rules="none" frame="void"
161
+<table width="100%" border=0 rules="none" frame="void"
Lines 243-260 Link Here
243
+<tr valign="top" align="left">
163
+<tr valign="top" align="left">
244
+<td width="22%"></td>
164
+<td width="22%"></td>
245
+<td width="78%">
165
+<td width="78%">
246
+<p>Default: %etc&minus;dir%/phishing.safe.sites.conf</p>
166
+<p>&minus; a perl reference to the list of line of the
247
+<!-- INDENTATION -->
167
+message</p></td>
248
+<p>There are some companies, such as banks, that insist on
249
+sending out email messages with links in them that are
250
+caught by the &quot;Find Phishing Fraud&quot; test described
251
+above. This is the name of a file which contains a list of
252
+link destinations which should be ignored in the test. This
253
+may, for example, contain the known websites of some banks.
254
+See the file itself for more information. This can only be
255
+the name of the file containing the list, it *cannot* be the
256
+filename of a ruleset.</p>
257
+</td>
258
+</table>
168
+</table>
259
+<!-- INDENTATION -->
169
+<!-- INDENTATION -->
260
+<table width="100%" border=0 rules="none" frame="void"
170
+<table width="100%" border=0 rules="none" frame="void"
Lines 262-275 Link Here
262
+<tr valign="top" align="left">
172
+<tr valign="top" align="left">
263
+<td width="11%"></td>
173
+<td width="11%"></td>
264
+<td width="89%">
174
+<td width="89%">
265
 <p><b>Allow IFrame Tags</b></p></td>
175
+<p><b>Max Custom Spam Scanner Size</b></p></td>
266
 </table>
267
 <!-- INDENTATION -->
268
@@ -3617,6 +3826,50 @@
269
 <tr valign="top" align="left">
270
 <td width="11%"></td>
271
 <td width="89%">
272
+<p><b>Disarmed Modify Subject</b></p></td>
273
+</table>
176
+</table>
274
+<!-- INDENTATION -->
177
+<!-- INDENTATION -->
275
+<table width="100%" border=0 rules="none" frame="void"
178
+<table width="100%" border=0 rules="none" frame="void"
Lines 277-289 Link Here
277
+<tr valign="top" align="left">
180
+<tr valign="top" align="left">
278
+<td width="22%"></td>
181
+<td width="22%"></td>
279
+<td width="78%">
182
+<td width="78%">
280
+<p>Default: yes</p>
183
+<p>Default: 20000</p>
281
+<!-- INDENTATION -->
184
+<!-- INDENTATION -->
282
+<p>If HTML tags in the message were &quot;disarmed&quot; by
185
+<p>How much of the message should be passed tot he Custom
283
+using the HTML &quot;Allow&quot; options above with the
186
+Spam Scanner. Most spam tools only need the first 20kbytes
284
+&quot;disarm&quot; settings, do you want to modify the
187
+of the message to determine if it is spam or not. Passing
285
+subject line? This can also be the filename of a
188
+more than is necessary only slows things down. This can also
286
+ruleset.</p>
189
+be the filename of a ruleset.</p>
287
+</td>
190
+</td>
288
+</table>
191
+</table>
289
+<!-- INDENTATION -->
192
+<!-- INDENTATION -->
Lines 292-298 Link Here
292
+<tr valign="top" align="left">
195
+<tr valign="top" align="left">
293
+<td width="11%"></td>
196
+<td width="11%"></td>
294
+<td width="89%">
197
+<td width="89%">
295
+<p><b>Disarmed Subject Text</b></p></td>
198
+<p><b>Custom Spam Scanner Timeout</b></p></td>
296
+</table>
199
+</table>
297
+<!-- INDENTATION -->
200
+<!-- INDENTATION -->
298
+<table width="100%" border=0 rules="none" frame="void"
201
+<table width="100%" border=0 rules="none" frame="void"
Lines 300-310 Link Here
300
+<tr valign="top" align="left">
203
+<tr valign="top" align="left">
301
+<td width="22%"></td>
204
+<td width="22%"></td>
302
+<td width="78%">
205
+<td width="78%">
303
+<p>Default: {Disarmed}</p>
206
+<p>Default: 20</p>
304
+<!-- INDENTATION -->
207
+<!-- INDENTATION -->
305
+<p>This is the text to add to the start of the subject if
208
+<p>How long should the custom spam scanner take to run? If
306
+the &quot;Disarmed Modify Subject&quot; option is set. This
209
+it takes more seconds than this, then it should be
307
+can also be the filename of a ruleset.</p>
210
+considered to have crashed and should be killed. This stops
211
+denial&minus;of&minus;service attacks.</p>
308
+</td>
212
+</td>
309
+</table>
213
+</table>
310
+<!-- INDENTATION -->
214
+<!-- INDENTATION -->
Lines 313-326 Link Here
313
+<tr valign="top" align="left">
217
+<tr valign="top" align="left">
314
+<td width="11%"></td>
218
+<td width="11%"></td>
315
+<td width="89%">
219
+<td width="89%">
316
 <p><b>Spam Modify Subject</b></p></td>
220
+<p><b>Max Custom Spam Scanner Timeouts</b></p></td>
317
 </table>
318
 <!-- INDENTATION -->
319
@@ -4118,6 +4371,33 @@
320
 <tr valign="top" align="left">
321
 <td width="11%"></td>
322
 <td width="89%">
323
+<p><b>Spam Lists To Be Spam</b></p></td>
324
+</table>
221
+</table>
325
+<!-- INDENTATION -->
222
+<!-- INDENTATION -->
326
+<table width="100%" border=0 rules="none" frame="void"
223
+<table width="100%" border=0 rules="none" frame="void"
Lines 328-344 Link Here
328
+<tr valign="top" align="left">
225
+<tr valign="top" align="left">
329
+<td width="22%"></td>
226
+<td width="22%"></td>
330
+<td width="78%">
227
+<td width="78%">
331
+<p>Default: 1</p>
228
+<p>Default: 10</p>
332
+<!-- INDENTATION -->
229
+<!-- INDENTATION -->
333
+<p>If a message appears in at least this number of
230
+<p>If the Custom Spam Scanner times out more times in a row
334
+&quot;Spam Lists&quot; (as defined above), then the message
231
+than this, then it will be marked as &quot;unavailable&quot;
335
+will be treated as spam and so the &quot;Spam Actions&quot;
232
+until MailScanner next re&minus;starts itself.</p>
336
+will happen, unless the message reaches the levels for
337
+&quot;High Scoring Spam&quot;. By default this is set to 1
338
+to mimic the previous behaviour, which means that appearing
339
+in any &quot;Spam Lists&quot; will cause the message to be
340
+treated as spam. This can also be the filename of a
341
+ruleset.</p>
342
+</td>
233
+</td>
343
+</table>
234
+</table>
344
+<!-- INDENTATION -->
235
+<!-- INDENTATION -->
Lines 347-368 Link Here
347
+<tr valign="top" align="left">
238
+<tr valign="top" align="left">
348
+<td width="11%"></td>
239
+<td width="11%"></td>
349
+<td width="89%">
240
+<td width="89%">
350
 <p><b>Spam Lists To Reach High Score</b></p></td>
241
+<p><b>Custom Spam Scanner Timeout History</b></p></td>
351
 </table>
352
 <!-- INDENTATION -->
353
@@ -5122,6 +5402,28 @@
354
 <p>Log all occurrences of &quot;Silent Viruses&quot; as
355
 defined above? This can only be a simple yes/no value, not a
356
 ruleset.</p>
357
+</td>
358
+</table>
359
+<!-- INDENTATION -->
360
+<table width="100%" border=0 rules="none" frame="void"
361
+       cols="2" cellspacing="0" cellpadding="0">
362
+<tr valign="top" align="left">
363
+<td width="11%"></td>
364
+<td width="89%">
365
+<p><b>Log Dangerous HTML Tags</b></p></td>
366
+</table>
242
+</table>
367
+<!-- INDENTATION -->
243
+<!-- INDENTATION -->
368
+<table width="100%" border=0 rules="none" frame="void"
244
+<table width="100%" border=0 rules="none" frame="void"
Lines 370-381 Link Here
370
+<tr valign="top" align="left">
246
+<tr valign="top" align="left">
371
+<td width="22%"></td>
247
+<td width="22%"></td>
372
+<td width="78%">
248
+<td width="78%">
373
+<p>Default: no<br>
249
+<p>Default: 20</p>
374
+Log all occurrences of HTML tags found in messages, that can
250
+<!-- INDENTATION -->
375
+be blocked. This will help you build up your whitelist of
251
+<p>The total number of Custom Spam Scanner attempts during
376
+message sources for which particular HTML tags should be
252
+which &quot;Max Custom Spam Scanner Timeouts&quot; will
377
+allowed, such as mail from newsletters and daily cartoon
253
+cause the Custom Spam Scanner to be marked as
378
+strips. This can also be the filename of a ruleset.</p>
254
+&quot;unavailable&quot;. See the previous comment for more
255
+information. The default values of 10 and 20 mean that 10
256
+timeouts in any sequence of 20 attempts will trigger the
257
+behaviour described above, until the next periodic restart
258
+(see &quot;Restart Every&quot;).</p>
379
 </td>
259
 </td>
380
 </table>
260
 </table>
381
 <a name="Advanced SpamAssassin Settings"></a>
261
 <a name="What to do with spam"></a>

Return to bug 83139