kpriv/freebsd-ports
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
freebsd-ports/mail/MailScanner-devel/files/patch-docs:man:MailScanner.conf.5.html
Yen-Ming Lee 47ccd8762e update to mailscanner-4.22.5 
PR:		55461
Submitted by:	services-root <j.koopmann@seceidos.de>
2003-08-12 07:38:55 +00:00

109 KiB
Raw Blame History

--- ../MailScanner-4.22-5.old/docs/man/MailScanner.conf.5.html Mon Aug 11 12:15:30 2003 +++ docs/man/MailScanner.conf.5.html Mon Aug 11 12:36:06 2003 @@ -1,8 +1,11 @@ - - + + + <html> <head> + </head> @@ -42,7 +45,7 @@ - +

MailScanner.conf − Main configuration for MailScanner

@@ -54,7 +57,7 @@ - + @@ -65,7 +68,7 @@

none

- +

MailScanner is configured using the file MailScanner.conf. The location of this file varies from @@ -76,24 +79,24 @@ - + - - + -

Linux:

 +

/etc/MailScanner

 +
- +

FreeBSD: /usr/local/etc/MailScanner
Other: /opt/MailScanner/etc

@@ -128,7 +131,7 @@ - +

Max Children
@@ -136,8 +139,8 @@ - - +
+

Default: 5

MailScanner uses your server efficiently by running @@ -153,7 +156,7 @@ - +

Run as User
@@ -161,8 +164,8 @@ - - +
+

Default: not to change user

Provided for Exim users (and anyone not running sendmail @@ -174,7 +177,7 @@ - +

Run as Group
@@ -182,8 +185,8 @@ - - +
+

Default: not to change group

Provided for Exim users (and anyone not running sendmail @@ -195,7 +198,7 @@ - +

Queue Scan Interval
@@ -203,8 +206,8 @@ - - +
+

Default: 5

How often (in seconds) should each process check the @@ -219,7 +222,7 @@ - +

Incoming Queue Dir
@@ -227,8 +230,8 @@ - - +
+

Default: /var/spool/mqueue.in

Directory in which MailScanner should find e−mail @@ -248,7 +251,7 @@ - +

Outgoing Queue Dir
@@ -256,8 +259,8 @@ - - +
+

Default: /var/spool/mqueue

Directory in which MailScanner should place scanned @@ -269,7 +272,7 @@ - +

Incoming work dir
@@ -277,8 +280,8 @@ - - +
+

Default: /opt/MailScanner/var/incoming
Default FreeBSD: /var/spool/MailScanner/incoming

@@ -290,7 +293,7 @@ - +

Quarantine Dir
@@ -298,8 +301,8 @@ - - +
+

Default: /opt/MailScanner/var/quarantine
Default FreeBSD: /var/spool/MailScanner/quarantine

@@ -312,7 +315,7 @@ - +

PID file
@@ -320,8 +323,8 @@ - - +
+

Default: /opt/MailScanner/var/MailScanner.pid
Default FreeBSD: /var/run/MailScanner.pid

@@ -335,7 +338,7 @@ - +

Restart Every
@@ -343,8 +346,8 @@ - - + - - + -
+

Default: 14400

To avoid resource leaks the MailScanner parent process @@ -362,20 +365,20 @@

MTA

 +

Default: sendmail

 +
- - +
+

MailScanner works with sendmail and exim. Since the queue handling differs a bit, you have to tell MailScanner which MTA you are using. Valid options are sendmail and exim.

@@ -385,7 +388,7 @@ - +

Sendmail
@@ -393,8 +396,8 @@ - - +
+

Default: /usr/lib/sendmail
Default FreeBSD: /usr/sbin/sendmail

@@ -408,7 +411,7 @@ - +

Sendmail2
@@ -416,8 +419,8 @@ - - +
+

Default: same value as the Sendmail setting

Sendmail2 is provided for exim users. It is the command @@ -433,7 +436,7 @@ - +

Max Unscanned Bytes Per Scan
@@ -441,8 +444,8 @@ - - +
+

Default: 100000000

MailScanner handles messages in batches for efficiency. @@ -460,7 +463,7 @@ - +

Max Unsafe Bytes per Scan
@@ -468,8 +471,8 @@ - - +
+

Default: 50000000

This setting limits the total size of messages per batch @@ -480,7 +483,7 @@ - +

Max Unscanned Messages Per Scan
@@ -488,8 +491,8 @@ - - +
+

Default: 100

This setting limits the total number of messages per @@ -501,7 +504,7 @@ - +

Max Unsafe Messages per Scan
@@ -509,8 +512,8 @@ - - +
+

Default: 100

This setting limits the total number of messages per @@ -522,7 +525,7 @@ - +

Expand TNEF
@@ -530,8 +533,8 @@ - - +
+

Default: yes

TNEF is primarily used by Microsoft programs such as @@ -551,7 +554,7 @@ - +

Deliver Unparsable TNEF
@@ -559,8 +562,8 @@ - - +
+

Default: no

Rich Text format attachments produced by some versions of @@ -578,7 +581,7 @@ - +

TNEF Expander
@@ -586,8 +589,8 @@ - - +
+

Default: /opt/MailScanner/bin/tnef
Default FreeBSD: /usr/local/bin/tnef

@@ -601,7 +604,7 @@ - +

TNEF Timeout
@@ -609,8 +612,8 @@ - - +
+

Default: 120

The maximum length of time (in seconds) the TNEF Expander @@ -621,7 +624,7 @@ - +

File Command
@@ -629,8 +632,8 @@ - - +
+

Default: /usr/bin/file

Where the "file" command is installed. This is @@ -643,7 +646,7 @@ - +

File Timeout
@@ -651,8 +654,8 @@ - - +
+

Default: 20

The maximum length of time the "file" command @@ -664,7 +667,7 @@ - +

Block Encrypted Messages
@@ -672,8 +675,8 @@ - - +
+

Default: no

This is inteded for use with a ruleset to ensure that @@ -687,7 +690,7 @@ - +

Block Unencrypted Messages
@@ -695,8 +698,8 @@ - - +
+

Default: no

This is intended for use with a ruleset to ensure that @@ -709,7 +712,7 @@ - +

Maximum Message Size
@@ -717,8 +720,8 @@ - - +
+

Default: 0

The maximum size of any message including the headers. If @@ -735,7 +738,7 @@ - +

Allowed Sophos Error Messages
@@ -743,24 +746,34 @@ - - +
+

Default:

Anything on the next line that appears in brackets at the end of a line of output from Sophos will cause the error/infection to be ignored. Use of this option is dangerous, and should only be used if you are having trouble -with lots of corrupt PDF files, for example. Example:
+with lots of corrupt PDF files, for example. This option +allows for multiple strings as well. In this case, the +strings should be put in double quotes (") and each +string separated with commas. Examples:
Allowed Sophos Error Messages = corrupt format not -supported

+supported
+Allowed Sophos Error Messages = "corrupt", +"format not supported"

+ +

The first version will match "corrupt format not +supported" only. The second version will match +"corrupt" and "format not +supported".
- +

Sophos IDE Dir
@@ -768,8 +781,8 @@ - - +
+

Default: /usr/local/Sophos/ide

The directory (or a link to it) containing all the Sophos @@ -781,7 +794,7 @@ - +

Sophos Lib Dir
@@ -789,8 +802,8 @@ - - +
+

Default: /usr/local/Sophos/lib

The directory (or a link to it) containing all the Sophos @@ -803,7 +816,7 @@ - +

Monitors For Sophos Updates
@@ -811,8 +824,8 @@ - - +
+

Default: /usr/local/Sophos/ide/*ides.zip

SophosSAVI only: monitor each of these files for changes @@ -828,7 +841,7 @@ - +

Virus Scanning
@@ -836,8 +849,8 @@ - - +
+

Default: yes

Do you want to scan email for viruses? A few people @@ -856,7 +869,7 @@ - +

Virus Scanners
@@ -864,8 +877,8 @@ - - +
+

Default: none

Which Virus Scanning package to use. Possible choices are @@ -888,7 +901,7 @@ - +

Virus Scanner Timeout
@@ -896,8 +909,8 @@ - - +
+

Default: 300

The maximum time (in seconds) that the cirus scanner is @@ -908,7 +921,7 @@ - +

Deliver Disinfected Files
@@ -916,8 +929,8 @@ - - +
+

Default: yes

Should infected attached documents be automatically @@ -928,7 +941,7 @@ - +

Silent Viruses
@@ -936,8 +949,8 @@ - - +
+

Default: Klez Yaha−E Bugbear Braid−A WinEvar

@@ -951,20 +964,23 @@ fake addresses on messages they send, so there is no point informing the sender of the message, as it won’t actually be them who sent it anyway. Other words that can be -put in this list are the 2 special keywords
+put in this list are the 3 special keywords
HTML−IFrame: inserting this will stop senders being warned about HTML Iframe tags, when they are not allowed.
HTML−Codebase: inserting this will stop senders being warned about HTML Object Codebase tags, when they are not -allowed.

+allowed.
+All−Viruses: inserting this will stop senders being +warned about any virus, while still allowing you to warn +senders about HTML−based attacks.
- +

Still Deliver Silent Viruses
@@ -972,8 +988,8 @@ - - +
+

Default: yes

If this is set to yes then disinfected messsages that @@ -993,7 +1009,7 @@ - +

Allow Partial Messages
@@ -1001,8 +1017,8 @@ - - +
+

Default: no

Do you want to allow partial messages, which only contain @@ -1020,7 +1036,7 @@ - +

Allow External Message Bodies
@@ -1028,8 +1044,8 @@ - - +
+

Default: no

There is a mechanism, very rarely used, in which the body @@ -1049,7 +1065,7 @@ - +

Allow IFrame Tags
@@ -1057,8 +1073,8 @@ - - +
+

Default: no

Do you want to allow HTML <IFrame> tags in email @@ -1073,7 +1089,7 @@ - +

Log IFrame Tags
@@ -1081,8 +1097,8 @@ - - +
+

Default: no

You may receive complaints from your users that HTML @@ -1100,7 +1116,7 @@ - +

Allow Object Codebase Tags
@@ -1108,8 +1124,8 @@ - - +
+

Default: no

Do you want to allow HTML <Object Codebase=...> @@ -1123,7 +1139,7 @@ - +

Convert Dangerous HTML To Text
@@ -1131,8 +1147,8 @@ - - +
+

Default: no

When <IFrame> or <Object Codebase=...> HTML @@ -1149,7 +1165,7 @@ - +

Convert HTML To Text
@@ -1157,8 +1173,8 @@ - - +
+

Default: no

If you have users who are children, or who are offended @@ -1175,7 +1191,7 @@ - +

Allow Form Tags
@@ -1183,8 +1199,8 @@ - - +
+

Default: no

Do you want to allow <Form> tags in email messages? @@ -1200,7 +1216,7 @@ - +

Filename Rules
@@ -1208,8 +1224,8 @@ - - +
+

Default: /opt/MailScanner/etc/filename.rules.conf
Default Linux: /etc/MailScanner/filename.rules.conf
Default FreeBSD: @@ -1226,7 +1242,7 @@ - +

Filetype Rules
@@ -1234,8 +1250,8 @@ - - +
+

Default: /opt/MailScanner/etc/filetype.rules.conf
Default Linux: /etc/MailScanner/filetype.rules.conf
Default FreeBSD: @@ -1257,7 +1273,7 @@ - +

Quarantine Infections
@@ -1265,8 +1281,8 @@ - - +
+

Default: yes

Set this to store infected / dangerous attachments in @@ -1280,7 +1296,7 @@ - +

Quarantine Whole Message
@@ -1288,8 +1304,8 @@ - - +
+

Default: no

When an infected message is stored in the quarantine, a @@ -1301,7 +1317,7 @@ - +

Quarantine Whole Messages As Queue Files
@@ -1309,8 +1325,8 @@ - - +
+

Default: no

When an entire message is saved in the quarantine for any @@ -1329,7 +1345,7 @@ - +

Language Strings
@@ -1337,8 +1353,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/languages.conf
Default Linux: @@ -1356,7 +1372,7 @@ - +

Deleted Bad Filename Message Report
@@ -1364,8 +1380,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/deleted.filename.message.txt
Default Linux: @@ -1384,7 +1400,7 @@ - +

Deleted Virus Message Report
@@ -1392,8 +1408,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/deleted.virus.message.txt
Default Linux: @@ -1412,7 +1428,7 @@ - +

Stored Bad Filename Message Report
@@ -1420,8 +1436,8 @@ - - + +
+

Default: /opt/MailScanner/etc/reports/en/stored.filename.message.txt
Default Linux: @@ -1429,10 +1445,65 @@ Default FreeBSD: /usr/local/share/MailScanner/reports/en/stored.filename.message.txt

-

When an attachment is deleted from a message (and the -attachment has been stored in the quarantine) because the -filename failed the filename rules in force for the message, -it is replaced by the contents of this file. A few variable +

When an attachment is deleted and stored from a message +(and the attachment has been stored in the quarantine) +because the filename failed the filename rules in force for +the message, it is replaced by the contents of this file. A +few variable substitutions can be made in this file, an +example of each of which is contained in the supplied sample +file.

+
+ + + + + +
+

Deleted Bad Content Message Report

+ + + + + +
+

Default: +/opt/MailScanner/etc/reports/en/deleted.content.message.txt
+Default Linux: +/etc/MailScanner/reports/en/deleted.content.message.txt
+Default FreeBSD: +/usr/local/share/MailScanner/reports/en/deleted.content.message.txt

+ +

This report is sent when a message is deleted because it +contained bad or dangerous content. A few variable +substitutions can be made in this file, an example of each +of which is contained in the supplied sample file.

+
+ + + + + +
+

Stored Bad Content Message Report

+ + + + + @@ -1441,7 +1512,7 @@
+

Default: +/opt/MailScanner/etc/reports/en/stored.content.message.txt
+Default Linux: +/etc/MailScanner/reports/en/stored.content.message.txt
+Default FreeBSD: +/usr/local/share/MailScanner/reports/en/stored.content.message.txt

+ +

This report is sent when a message is stored because it +contained bad or dangerous content. A few variable substitutions can be made in this file, an example of each of which is contained in the supplied sample file.

- +

Disinfected Report
@@ -1449,8 +1520,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/disinfected.report.txt
Default Linux: @@ -1470,7 +1541,7 @@ - +

Inline HTML Signature
@@ -1478,8 +1549,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/inline.sig.html
Default Linux: @@ -1501,7 +1572,7 @@ - +

Inline Text Signature
@@ -1509,8 +1580,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/inline.sig.txt
Default Linux: @@ -1532,7 +1603,7 @@ - +

Sender Error Report
@@ -1540,8 +1611,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.error.report.txt
Default Linux: @@ -1561,7 +1632,7 @@ - +

Sender Bad Filename Report
@@ -1569,8 +1640,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.filename.report.txt
Default Linux: @@ -1579,14 +1650,14 @@ /usr/local/share/MailScanner/reports/en/sender.filename.report.txt

When an attachment is trapped by the filename rules, this -message is sent back to the sender. :

+message is sent back to the sender.
- +

Sender Virus Report
@@ -1594,8 +1665,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.virus.report.txt
Default Linux: @@ -1611,7 +1682,7 @@ - +

Hide Incoming Work Dir
@@ -1619,8 +1690,8 @@ - - +
+

Default: yes

When this option is set, the full directory in which the @@ -1633,7 +1704,7 @@ - +

Include Scanner Name in Reports
@@ -1641,14 +1712,20 @@ - - +
-

Default: no

+		 +

Default: yes

Include the name of the virus scanner in each of the -scanner reports. Very useful if you use several virus -scanners, but a bad idea if you don’t want to let your -customers know which scanners you use.

+scanner reports. This also includes the translation of +"MailScanner" in each of the report lines +resulting from one of MailScanner’s own checks such as +filename, filetype or dangerous HTML content. To change the +name "MailScanner", look in +reports/...../languages.conf.
+Very useful if you use several virus scanners, but a bad +idea if you don’t want to let your customers know +which scanners you use.
@@ -1657,7 +1734,7 @@ - +

Mail Header
@@ -1665,8 +1742,8 @@ - - +
+

Default: X−MailScanner:

Extra header that should be added to all scanned messages @@ -1679,7 +1756,7 @@ - +

Spam Header
@@ -1687,8 +1764,8 @@ - - +
+

Default: X−MailScanner−SpamCheck:

Name of the header to add to mail detected as spam. The @@ -1700,7 +1777,7 @@ - +

Spam Score Header
@@ -1708,8 +1785,8 @@ - - +
+

Default: X−MailScanner−SpamScore:

If the option "Spam Score" is set, this is the @@ -1721,7 +1798,7 @@ - +

Information Header
@@ -1729,8 +1806,8 @@ - - +
+

Default: X−MailScanner−Information:

Name of the header to add to all messages, to be used for @@ -1743,7 +1820,7 @@ - +

Detailed Spam Report
@@ -1751,8 +1828,8 @@ - - +
+

Default: yes

If this is set to yes then you get the normal fully @@ -1766,7 +1843,7 @@ - +

Include Scores In SpamAssassin Report
@@ -1774,8 +1851,8 @@ - - +
+

Default: yes

Do you want to include the numerical scores in the @@ -1787,7 +1864,7 @@ - +

Spam Score Character
@@ -1795,8 +1872,8 @@ - - +
+

Default: s

If the option "Spam Score" is set, this is the @@ -1809,7 +1886,7 @@ - +

Clean header Value
@@ -1817,8 +1894,8 @@ - - +
+

Default: Found to be clean

This is the text that is added to the "Mail @@ -1830,7 +1907,7 @@ - +

Infected Header Value
@@ -1838,8 +1915,8 @@ - - +
+

Default: Found to be infected

This is the text that is added to the "Mail @@ -1851,7 +1928,7 @@ - +

Disinfected Header Value
@@ -1859,8 +1936,8 @@ - - +
+

Default: Disinfected

This is the text that is added to the "Mail @@ -1874,7 +1951,7 @@ - +

Information Header Value
@@ -1882,8 +1959,8 @@ - - +
+

Default: Please contact the ISP for more information

This is the text that is added to the "Information @@ -1899,7 +1976,7 @@ - +

Multiple Headers
@@ -1907,8 +1984,8 @@ - - +
+

Default: append

When a message passes through more than one MailScanner @@ -1924,7 +2001,7 @@ - +

Hostname
@@ -1932,8 +2009,8 @@ - - +
+

Default: the MailScanner

This is the name of the MailScanner server that is put in @@ -1946,7 +2023,7 @@ - +

Sign Messages Already Processed
@@ -1954,8 +2031,8 @@ - - +
+

Default: no

If a message has already been processed by another @@ -1970,7 +2047,7 @@ - +

Sign Clean Messages
@@ -1978,8 +2055,8 @@ - - +
+

Default: no

If this option is set, then the "Inline HTML/Text @@ -1996,7 +2073,7 @@ - +

Mark Infected Messages
@@ -2004,8 +2081,8 @@ - - +
+

Default: yes

If this option is set, then the "Inline HTML/Text @@ -2020,7 +2097,7 @@ - +

Mark Unscanned Messages
@@ -2028,8 +2105,8 @@ - - +
+

Default: yes

If this option is set, then any message which is not @@ -2044,7 +2121,7 @@ - +

Unscanned Header Value
@@ -2052,8 +2129,8 @@ - - +
+

Default: Not scanned: please contact your Internet E−Mail Service Provider for details

@@ -2068,7 +2145,7 @@ - +

Deliver Cleaned Messages
@@ -2076,8 +2153,8 @@ - - +
+

Default: yes

Once a message has had all viruses and dangerous content @@ -2094,7 +2171,7 @@ - +

Notify Senders
@@ -2102,8 +2179,8 @@ - - +
+

Default: yes

If this option is set, a message will be sent back to the @@ -2116,7 +2193,7 @@ - +

Never Notify Senders Of Precedence
@@ -2124,8 +2201,8 @@ - - +
+

Default: list bulk

This contains a space−separated list of message @@ -2142,7 +2219,7 @@ - +

Scanned Modify Subject
@@ -2150,8 +2227,8 @@ - - +
+

Default: no # end

If this is set to "start" or "end" @@ -2165,7 +2242,7 @@ - +

Scanned Subject Text
@@ -2173,8 +2250,8 @@ - - +
+

Default: {Scanned}

This is the text inserted at the start or the end of the @@ -2186,7 +2263,7 @@ - +

Virus Modify Subject
@@ -2194,8 +2271,8 @@ - - +
+

Default: yes

If this is set, then the "Subject:" line of a @@ -2208,7 +2285,7 @@ - +

Virus Subject Text
@@ -2216,8 +2293,8 @@ - - +
+

Default: {Virus?}

This is the text inserted at the start of the @@ -2229,7 +2306,7 @@ - +

Filename Modify Subject
@@ -2237,21 +2314,21 @@ - - +
+

Default: yes

If this is set, then the "Subject:" line of a message that had an attachment with a dangerous filename -will have the "Virus Subject Text" text inserted -at the start.

+will have the "Filename Subject Text" text +inserted at the start.
- +

Filename Subject Text
@@ -2259,9 +2336,9 @@ - - +
-

Default: yes

+		 +

Default: {Virus?}

This is the text inserted at the start of the "Subject:" line if the "Filename Modify @@ -2272,7 +2349,50 @@ - + + +

+

Content Modify Subject

+ + + + + +
+

Default: yes

+ +

If this is set, then the "Subject:" line of a +message that triggered a content check without anything else +wrong in the message will have the "Content Subject +Text" text inserted at the start.

+
+ + + + + +
+

Content Subject Text

+ + + + + +
+

Default: {Filename?}

+ +

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

+
+ + + +

Spam Modify Subject
@@ -2280,8 +2400,8 @@ - - +
+

Default: yes

If this is set, then the "Subject:" line of a @@ -2294,7 +2414,7 @@ - +

Spam Subject Text
@@ -2302,8 +2422,8 @@ - - +
+

Default: {Spam?}

This is the text inserted at the start of the @@ -2315,7 +2435,7 @@ - +

High Scroing Spam Modify Subject
@@ -2323,8 +2443,8 @@ - - +
+

Default: yes

If this is set, then the "Subject:" line of a @@ -2338,7 +2458,7 @@ - +

High Scoring Spam Subject Text
@@ -2346,8 +2466,8 @@ - - +
+

Default: {Spam?}

This is the text inserted at the start of the @@ -2361,7 +2481,7 @@ - +

Warning Is Attachment
@@ -2369,8 +2489,8 @@ - - +
+

Default: yes

When an infected or dangerous attachment is replaced with @@ -2383,7 +2503,7 @@ - +

Attachment Warning Filename
@@ -2391,8 +2511,8 @@ - - +
+

Default: VirusWarning.txt

What an infected or dangerous attachment is replaced with @@ -2404,7 +2524,7 @@ - +

Attachment Encoding Charset
@@ -2412,8 +2532,8 @@ - - +
+

Default: us−ascii

This is the name of the encoding character set used for @@ -2429,7 +2549,7 @@ - +

Archive Mail
@@ -2437,8 +2557,8 @@ - - + @@ -2448,20 +2568,20 @@ cols="2" cellspacing="0" cellpadding="0"> - - - @@ -2470,8 +2590,8 @@
+

Default:

Space−separated list of any combination of

+

1. email addresses to which mail should be forwarded,
+

2. directory names where you want mail to be stored,
+

3. file names to which mail will be appended.

- - +
+

The files (option 3) are using the "mbox" format suitable for most Unix mail systems. These files must already exist since MailScanner will not create them!

@@ -2489,7 +2609,7 @@ - +

Send Notices
@@ -2497,8 +2617,8 @@ - - +
+

Default: yes

Should system administrators listed in the "Notices @@ -2509,7 +2629,7 @@ - +

Notives Include Full Headers
@@ -2517,8 +2637,8 @@ - - +
+

Default: no

If this option is set, then the system administrator @@ -2531,7 +2651,7 @@ - +

Hide Incoming Work Dir in Notices
@@ -2539,8 +2659,8 @@ - - +
+

Default: no

When this option is set, the full directory in which the @@ -2554,7 +2674,7 @@ - +

Notice Signature
@@ -2562,8 +2682,8 @@ - - +
+

Default: −− \nMailScanner\nEmail Virus Scanner\nwww.mailscanner.info

@@ -2578,7 +2698,7 @@ - +

Notices From
@@ -2586,8 +2706,8 @@ - - +
+

Default: MailScanner

The visible part of the email address used in the @@ -2600,7 +2720,7 @@ - +

Notices To
@@ -2608,8 +2728,8 @@ - - +
+

Default: postmaster

This option provides a list of the addresses to which @@ -2622,7 +2742,7 @@ - +

Local Postmaster
@@ -2630,8 +2750,8 @@ - - +
+

Default: postmaster

When virus warnings are sent to any users, this is the @@ -2645,7 +2765,7 @@ - +

Spam List Definitions
@@ -2653,8 +2773,8 @@ - - +
+

Default: /opt/MailScanner/etc/spam.lists.conf
Defualt Linux: /etc/MailScanner/spam.lists.conf
Default FreeBSD: @@ -2672,7 +2792,7 @@ - +

Virus Scanner Definitions
@@ -2680,8 +2800,8 @@ - - +
+

Default: /opt/MailScanner/etc/virus.scanners.conf
Default Linux: /etc/MailScanner/virus.scanners.conf
Default FreeBSD: @@ -2699,7 +2819,7 @@ - +

Spam Checks
@@ -2707,8 +2827,8 @@ - - +
+

Default: yes

If this option is set, messages will be checked to see if @@ -2719,7 +2839,7 @@ - +

Spam List
@@ -2727,8 +2847,8 @@ - - +
+

Default: ORDB−RBL Infinite−Monkeys

This provides a space−separated list of "Spam @@ -2744,7 +2864,7 @@ - +

Spam Domain List
@@ -2752,8 +2872,8 @@ - - +
+

Default:

This provides a space−separated list of "Spam @@ -2768,7 +2888,7 @@ - +

Spam Lists To Reach High Score
@@ -2776,8 +2896,8 @@ - - +
+

Default: 5

If a message appears in at least this number of @@ -2794,7 +2914,7 @@ - +

Spam List Timeout
@@ -2802,8 +2922,8 @@ - - +
+

Default: 10

This is the number of seconds to wait for each "Spam @@ -2815,7 +2935,7 @@ - +

Max Spam List Timeouts
@@ -2823,8 +2943,8 @@ - - +
+

Default: 7

If a "Spam List" lookup times out for this many @@ -2840,7 +2960,7 @@ - +

Is Definitely Not Spam
@@ -2848,8 +2968,8 @@ - - +
+

Default: /opt/MailScanner/etc/rules/spam.whitelist.rules
Default Linux: @@ -2869,7 +2989,7 @@ - +

Is Definitely Spam
@@ -2877,8 +2997,8 @@ - - +
+

Default: no

This option would normally be a ruleset. Any messages for @@ -2887,13 +3007,36 @@ "blacklist" of addresses of known spammers.
+ + + + + +
+

Definite Spam Is High Scoring

+ + + + + +
+

Default: no

+ +

Setting this to yes means that spam found in the +blacklist is treated as "High Scoring Spam" in the +"Spam Actions" section below. Setting it to no +means that it will be treated as "normal" spam. +This can also be the filename of a ruleset.

+

SpamAssassin

- +

Use SpamAssassin
@@ -2901,8 +3044,8 @@ - - +
+

Default: no

Do you want to detect spam using the very good @@ -2919,7 +3062,7 @@ - +

Max SpamAssassin Size
@@ -2927,8 +3070,8 @@ - - +
+

Default: 90000

SpamAssassin is quite slow when processing very large @@ -2942,7 +3085,7 @@ - +

Required Spam Assassin Score
@@ -2950,8 +3093,8 @@ - - +
+

Default: 5

This gives the minimum SpamAssassin score value above @@ -2965,7 +3108,7 @@ - +

High SpamAssassin Score
@@ -2973,8 +3116,8 @@ - - +
+

Default: 20

Messages with a SpamAssassin score greater than this @@ -2987,7 +3130,7 @@ - +

SpamAssassin Auto Whitelist
@@ -2995,8 +3138,8 @@ - - +
+

Default: no

SpamAssassin has a feature which measures the ratio of @@ -3012,7 +3155,7 @@ - +

SpamAssassin Prefs File
@@ -3020,8 +3163,8 @@ - - +
+

Default: /opt/MailScanner/etc/spam.assassin.prefs.conf
Default Linux: /etc/MailScanner/spam.assassin.prefs.conf
@@ -3041,7 +3184,7 @@ - +

SpamAssassin Timeout
@@ -3049,8 +3192,8 @@ - - +
+

Default: 30

This option sets the maximum number of seconds to wait @@ -3063,7 +3206,7 @@ - +

Max SpamAssasin Timeouts
@@ -3071,8 +3214,8 @@ - - +
+

Default: 20

If several consecutive calls to SpamAssassin time out, @@ -3086,7 +3229,7 @@ - +

Check SpamAssassin If On Spam List
@@ -3094,8 +3237,8 @@ - - +
+

Default: yes

If a message has already triggered any of the "Spam @@ -3109,7 +3252,7 @@ - +

Always Include SpamAssasin Report
@@ -3117,8 +3260,8 @@ - - +
+

Default: no

If this option is set, then the "Spam Header" @@ -3131,7 +3274,7 @@ - +

Spam Score
@@ -3139,8 +3282,8 @@ - - +
+

Default: yes

If a message is spam, and this option is set, then a @@ -3157,7 +3300,7 @@ - +

Spam Actions
@@ -3165,8 +3308,8 @@ - - +
+

Default: deliver

This can be any combination of 1 or more of the following @@ -3205,7 +3348,7 @@ - +

High Scoring Spam Actions
@@ -3213,8 +3356,8 @@ - - +
+

Default: deliver

This is the same as the "Spam Actions" option @@ -3227,7 +3370,7 @@ - +

Non Spam Actions
@@ -3235,8 +3378,8 @@ - - +
+

Default: deliver

This is the same as the "Spam Actions" option @@ -3249,7 +3392,7 @@ - +

Sender Spam Report
@@ -3257,8 +3400,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.spam.report.txt
Default Linux: @@ -3276,7 +3419,7 @@ - +

Sender Spam List Report
@@ -3284,8 +3427,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.spam.rbl.report.txt
Default Linux: @@ -3302,7 +3445,7 @@ - +

Sender SpamAssassin Report
@@ -3310,8 +3453,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/sender.spam.sa.report.txt
Default Linux: @@ -3328,7 +3471,7 @@ - +

Inline Spam Warning
@@ -3336,8 +3479,8 @@ - - +
+

Default: /opt/MailScanner/etc/reports/en/inline.spam.warning.txt
Default Linux: @@ -3356,7 +3499,7 @@ - +

Syslog Facility
@@ -3364,8 +3507,8 @@ - - +
+

Default: mail

This is the name of the "facility" used by @@ -3378,7 +3521,7 @@ - +

Log Spam
@@ -3386,8 +3529,8 @@ - - +
+

Default: no

If this option is set, then every spam message will be @@ -3402,7 +3545,7 @@ - +

Log Permitted Filenames
@@ -3410,8 +3553,8 @@ - - +
+

Default: no

If this option is set, then every attachment filename @@ -3425,7 +3568,7 @@ - +

Log Permitted Filetypes
@@ -3433,8 +3576,8 @@ - - +
+

Default: no

Log all the filenames that are allowed by the Filetype @@ -3448,7 +3591,7 @@ - +

If you are using Postfix you may well need to use some of the settings below, as the home directory for the @@ -3462,7 +3605,7 @@ - +

SpamAssassin User State Dir
@@ -3470,8 +3613,8 @@ - - + - -
+

Default:

The per−user files (bayes, auto−whitelist, @@ -3486,13 +3629,13 @@ cols="2" cellspacing="0" cellpadding="0">

+

mkdir /var/spool/MailScanner/spamassassin
+

chown postfix.postfix /var/spool/MailScanner/spamassassin

@@ -3502,7 +3645,7 @@ - +

SpamAssassin Install Prefix
@@ -3510,8 +3653,8 @@ - - +
+

Default:

This setting is useful if SpamAssassin is installed in an @@ -3526,7 +3669,7 @@ - +

SpamAssassin Local Rules Dir
@@ -3534,8 +3677,8 @@ - - +
+

Default:

The site−local rules are searched for here, and in @@ -3550,7 +3693,7 @@ - +

SpamAssassin Default Rules Dir
@@ -3558,8 +3701,8 @@ - - + - + -
+

Default:

The default rules are searched for here, and in @@ -3580,20 +3723,20 @@

Debug

Default: no

 +
- - +
+

Not for use by normal users. Setting this option to "yes" will put MailScanner into debugging mode, in which it creates slightly more output and will not become a @@ -3604,7 +3747,7 @@ - +

Debug SpamAssassin
@@ -3612,8 +3755,8 @@ - - +
+

Default: no

Do you want to debug SpamAssassin from within @@ -3624,7 +3767,7 @@ - +

Always Looked Up Last
@@ -3632,8 +3775,8 @@ - - +
+

Default: no

The value of the option is actually never used, but it is @@ -3649,7 +3792,7 @@ - +

Deliver in Background
@@ -3657,8 +3800,8 @@ - - +
+

Default: yes

When attempting delivery of any messages (when the @@ -3673,7 +3816,7 @@ - +

Lockfile Dir
@@ -3681,8 +3824,8 @@ - - +
+

Default: /tmp

This is the directory in which lock files are placed to @@ -3697,7 +3840,7 @@ - +

Lock Type
@@ -3705,8 +3848,8 @@ - - +
+

Do not set this option to anything unless you know exactly what you are doing. For sendmail and Exim, MailScanner will choose the correct value by default. This @@ -3720,7 +3863,7 @@ - +

Minimum Code Status
@@ -3728,8 +3871,8 @@ - - +
+

Default: supported

Some of the virus scanners are not supported by the @@ -3747,7 +3890,7 @@ - +

Split Exim Spool
@@ -3755,8 +3898,8 @@ - - +
+

Default: yes

Are you using Exim with split spool directories? If you @@ -3765,13 +3908,51 @@ information about split spool directories.
+ + + + + +
+

Use Default Rules With Multiple +Recipients

+ + + + + +
+

Default: no

+ +

When trying to work out the value of configuration +parameters which are using a ruleset, this controls the +behaviour when a rule is checking the "To:" +addresses. If this option is set to "yes", then +the following happens when checking the ruleset:

+ +

a) 1 recipient. Same behaviour as normal.
+b) Several recipients, but all in the same domain +(domain.com for example). The rules are checked for one that +matches the string "*@domain.com".
+c) Several recipients, not all in the same domain. The rules +are checked for one that matches the string +"*@*".

+ +

If this option is set to "no", then some rules +will use the result they get from the first matching rule +for any of the recipients of a message, so the exact value +cannot be predicted for messages with more than 1 recipient. +This value *cannot* be the filename of a ruleset.

+

RULESETS

- +

Ruleset files should all be put in /opt/MailScanner/etc/rules (FreeBSD: @@ -3795,35 +3976,39 @@

+ cols="5" cellspacing="0" cellpadding="0"> - - + + - - + +

From:

 +

Matches when the message is from a matching address

 +

To:

 +

Matches when the message is to a matching address

 +
- +

FromOrTo:
@@ -3831,8 +4016,8 @@ - - + @@ -3841,7 +4026,7 @@
+

Matches when the message is from or to a matching address

- +

FromAndTo:
@@ -3849,8 +4034,8 @@ - - + @@ -3859,7 +4044,7 @@
+

Matches when the message is from and to a matching address

- + +

The syntax of these is very loosely defined. Any word containing "from", any word containing @@ -3867,12 +4052,25 @@ "to" (in either order), and any word containing "and" will work just fine. You can put them in upper or lower case, it doesn’t matter. And any -additional punctuation will be ignored.

+additional punctuation will be ignored.

+ + + + +

This specifies the whether the rule should be matched against the sender’s address (or IP address), or the recipient’s address.

+
+ + + +

2. The pattern describes what messages should match this rule. Some examples are:

@@ -3911,7 +4109,7 @@ - +

This is held in the filename pointed to by the configuration option Filename rules. It contains a set of @@ -3951,7 +4149,7 @@ - +

allow / deny
@@ -3959,8 +4157,8 @@ - - + @@ -3969,7 +4167,7 @@
+

Accept or reject the attachment if its filename matches the regular expression

- +

regular expression
@@ -3977,8 +4175,8 @@ - - +
+

The rule is executed if the attachment matches this expression. It may optionally be surrounded in ’/’ characters.

@@ -3988,7 +4186,7 @@ - +

log text
@@ -3996,8 +4194,8 @@ - - + @@ -4006,7 +4204,7 @@
+

If the rule matches, this text is placed in the syslog. If the text is "−", no string is logged.

- +

user text
@@ -4014,8 +4212,8 @@ - - +
+

If the rule matches, this text is placed in the text message sent to the user. If the text is "−", no text is used.

@@ -4025,7 +4223,7 @@ - +

Please have a look at the filename.rules.conf or filename.rules.conf.sample file provided with this @@ -4038,7 +4236,7 @@ - +

MailScanner(1)