--- ../MailScanner-install-4.32.4.orig/docs/man/MailScanner.conf.5.html Wed Jul 28 13:28:57 2004 +++ docs/man/MailScanner.conf.5.html Wed Jul 28 13:29:22 2004 @@ -1,5 +1,5 @@ - + @@ -220,7 +220,25 @@ headers.

- +

System Settings

+ + + + + +
+

Max Children

+ + + + + +
+

Default: 5

+ +

MailScanner uses your server efficiently by running several identical processes at the same time, all processing mail. This is the number of these processes to run at once. Turning this figure will optimise the performance of your @@ -497,7 +515,31 @@

To avoid resource leaks the MailScanner parent process stops and restarts its child processes from time to time. -Set the amount of seconds ea"top" align="left"> +Set the amount of seconds each child process is supposed to +live here.

+
+ + + + + + + + +
+ +

MTA

+
+ +

Default: sendmail

+
+
+ + + +

MailScanner works with sendmail and exim. Since the queue @@ -730,7 +772,20 @@

If you want processes running under the same *group* as MailScanner to be able to read the quarantined files (and -list what is in the directories, of course), set to 06="2" cellspacing="0" cellpadding="0"> +list what is in the directories, of course), set to 0640. If +you want *all* other users to be able to read them, set to +0644. For a detailed description, if you’re not +already familiar with it, refer to ‘man 2 +chmod‘. Typical use: let the webserver have access to +the files so users can download them if they really want to. +Use with care, you may well open security holes.

+
+ +

Process Incoming Mail

+ +
@@ -975,7 +1030,22 @@

File Command

- + + + + +
+

Default: /usr/bin/file

+ +

Where the "file" command is installed. This is +used for checking the content type of files, regardless of +their filename. To disable Filetype checking, set this value +to blank.

+
+ + @@ -1216,7 +1286,23 @@ +
-

Default: /usr/l100%" border=0 rules="none" frame="void" +

Default: /usr/local/Sophos/ide

+ +

The directory (or a link to it) containing all the Sophos +*.ide files. This is only used by the "sophossavi" +virus scanner, and is irrelevant for all other scanners.

+
+ + + + + +
+

Sophos Lib Dir

+ + @@ -1303,7 +1389,8 @@ kaspersky−4.5, kavdaemonclient, inoculate, inoculan, nod32, nod32−1.99, f−secure, f−prot, panda, rav, antivir, clamav, clamavmodule, css, trend, -norman, avg, vexira, none (no virus scanning at all)

+norman, avg, vexira, none (no virus scanning at all). This +*cannot* be the filename of a ruleset.

Note for McAfee users: Do NOT use any symlinks with McAfee at all. It is very strange but McAfee may not detect @@ -1313,6 +1400,13 @@

Note: If you want to use multiple virus scanners, then this should be a space−separated list of virus scanners.

+ +

Note: Make sure that you check that the base installation +directory in the 3rd column of virus.scanners.conf matches +the location you have installed each of your virus scanners. +The supplied virus.scanners.conf file assumes the default +installation locations recommended by each of the virus +scanner installation guides.

@@ -1468,7 +1562,19 @@

Still Deliver Silent Viruses

- + + +
+

Default: no

+ +

If this is set to yes then disinfected messsages that +originally contained one of the "silent" viruses +will still be delivered to the original recipients, even +those addresses were chosen at random by the infected PC and +do not correspond to anything a user intended to send. Set +this to yes so that your users (and your management) appreciate how much MailScanner is doing to protect them, but set it to no if they complain a lot about receiving lots of virus warnings.

@@ -1710,7 +1816,32 @@
- + + + + + + + + + + + + +
+ +

+
+ +

yes => Allow these tags to be in the message

+
+ +

+
+ +

no => Ban messages containing these tags

+

@@ -2009,7 +2140,24 @@

Default: no

Do you want to allow <Form> tags in email messages? -This is a bad idea as these are used as order=0 rules="none" frame="void" +This is a bad idea as these are used as scams to pursuade +people to part with credit card information and other +personal data. This can also be the filename of a +ruleset.

+
+ +

Attachment filename checking

+ + + + + +
+

Filename Rules

+ + @@ -2244,7 +2392,23 @@ example of each of which is contained in the supplied sample file.

- +
+ + + + + +
+

Deleted Bad Content Message Report

+ + + + + +
+

Default: +/%reports−dir%/deleted.content.message.txt

This report is sent when a message is deleted because it contained bad or dangerous content. A few variable @@ -2484,7 +2648,23 @@

Default: X−MailScanner:

-

Extra header that should be added to all scanned me cols="2" cellspacing="0" cellpadding="0"> +

Extra header that should be added to all scanned messages +to show they have been scanned. You might want to add an +abbreviation of your site name to this, so that you can find +headers that are added by your MailScanner server.

+
+ + + + + +
+

Spam Header

+ + +
@@ -2737,7 +2917,24 @@ SpamAssassin score. This means that people who only filter on the "Spam Stars" will still be able to catch messages which receive a very low SpamAssassin score. Set -this valdth="78%"> +this value to 0 to disable it. This can also be the filename +of a ruleset.

+
+ + + + + +
+

Clean header Value

+ + + + + +

Default: Found to be clean

This is the text that is added to the "Mail @@ -2977,7 +3174,23 @@ E−Mail Service Provider for details

This supplies the text that is placed in the "Mail -Header" of messages that have not been scanned, if"0" cellpadding="0"> +Header" of messages that have not been scanned, if the +option "Mark Unscanned Messages" is set. It is a +useful place to advertise your MailScanner service to new +customers/clients.

+
+ + + + + +
+

Deliver Cleaned Messages

+ + +
@@ -3227,7 +3440,23 @@
-Filename Subject Text

+ + + + + +
+

Default: {Virus?}

+ +

This is the text inserted at the start of the +"Subject:" line if the "Filename Modify +Subject" option is set.

+
+ + @@ -3483,7 +3712,22 @@ format suitable for most Unix mail systems. These files must already exist since MailScanner will not create them!

-

If you give this option a ruleset, you can Notices

+

If you give this option a ruleset, you can control +exactly whose mail is archived or forwarded. If you do this, +beware of the legal implications as this could be deemed to +be illegal interception unless the police have asked you to +do this.

+ +
+ +

Notices to system administrators

+ + + + +
+

Send Notices

+
-

Spam D be defined in the "Spam List +

Spam Domain List

+ + + + +
+

Default:

+ +

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.

@@ -3974,7 +4232,23 @@

SpamAssassin is quite slow when processing very large messages. To work round this problem, this option provides a -maximum size for messages that are processed"> +maximum size for messages that are processed with +SpamAssassin. Most real spam is usually less than about +50,000 bytes per message.

+ + + + + + + +
+

Required Spam Assassin Score

+ + + +rebuild and expiry at regular intervals. This is measures in +seconds. 24 hours = 86400 seconds. To disable this feature +set this to 0.

+ +

Default: 6

@@ -4216,7 +4490,24 @@

If you are using the Bayesian statistics engine on a busy server, you may well need to force a Bayesian database -rebuild and expiry at regular intervals. This is measuth="22%">

+ + + + + +
+

Wait During Bayes Rebuild

+ + + + - +

Default: no

@@ -4502,7 +4793,23 @@

Recipient Spam Report

+ + + + + +
+

Default: +%reports−dir%/recipient.spam.report.txt

+ +

If you use the ’notify’ Spam Action or High +Scoring Spam Action then this is the location of the +notification message that is sent to the original recipients +of the message.

+
+ @@ -4748,7 +5055,22 @@

SpamAssassin Local Rules Dir

- +
+ + + +
+

Default:

+ +

This tells MailScanner where to look for the +site−local rules. If this is set it adds to the list +of places that are searched. MailScanner will always look at +the following places (even if this option is not set):

+
+ +
@@ -4913,27 +5235,94 @@

Advanced Settings

+ + + + + +
+

Spam Score Number Format

+ + + + + +
+

Default: %d

+ +

When putting the value of the spam score of a message +into the headers, how do you want to format it. If you +don’t know how to use sprintf() or printf() in C, +please *do not modify* this value. This can also be the +filename of a ruleset. A few examples for you:

+
- - - + - + + + + + + + + + + + + + + + + + +
+ -

Debug

+

%d

+ -

Default: no

+

==> 12

+ +
+ +

%5.2f

+
+ +

==> 12.34

+
+
+ +

%05.1f

+
+ +

==> 012.3

+
+
+ +

Debug

+
+ + +
+

Default: no

+ + +

Not for use by normal users. Setting this option to @@ -5085,7 +5474,23 @@

Deliver in Background

- + + + +
+

Default: yes

+ +

When attempting delivery of any messages (when the +"Delivery Method = batch") the sendmail/Exim +command will be run in the background so that MailScanner +does not have to wait for the delivery attempt to complete. +There are very few good reasons for setting this to +"no".

+
+ + @@ -5361,7 +5766,23 @@ end in ".rules" wherever possible.

All blank lines are ignored, and comments start with -"#" and continue to the end of the liing="0"> +"#" and continue to the end of the line, like +this: # This line is just a comment

+ +

Other than that, every line is a rule and looks like this +example: From: john.doe@domain.com yes

+ +

As you can see, each rule has 3 fields:
+1. Direction
+2. Pattern to match
+3. Result value (or values)

+ +

1. Direction should be one of the following:

+ +
+ + +
@@ -5610,4 +6031,22 @@
-

Please have a look at the filename.rules.co \ No newline at end of file +

Please have a look at the filename.rules.conf or +filename.rules.conf.sample file provided with this +distribution/package/port.

+
+ +

SEE ALSO

+ + + + + +
+

MailScanner(8)

+
+
+ +