You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@spamassassin.apache.org by he...@apache.org on 2020/01/14 10:56:54 UTC
svn commit: r1872766 - /spamassassin/trunk/UPGRADE
Author: hege
Date: Tue Jan 14 10:56:53 2020
New Revision: 1872766
URL: http://svn.apache.org/viewvc?rev=1872766&view=rev
Log:
Sync UPGRADE notes from 3.4.3
Modified:
spamassassin/trunk/UPGRADE
Modified: spamassassin/trunk/UPGRADE
URL: http://svn.apache.org/viewvc/spamassassin/trunk/UPGRADE?rev=1872766&r1=1872765&r2=1872766&view=diff
==============================================================================
--- spamassassin/trunk/UPGRADE (original)
+++ spamassassin/trunk/UPGRADE Tue Jan 14 10:56:53 2020
@@ -2,12 +2,6 @@
Note for Users Upgrading to SpamAssassin 4.0.0
----------------------------------------------
-- OLEMAcro plugin has been renamed to OLEVBMacro, configuration
- should be changed accordingly
-
-- New subjprefix keyword added, this can be used to add a prefix to
- email Subject if the original email matches a particular rule
-
- All log output (stderr, file, syslog) is now escaped properly,
\r \n \t \\, and control chars, DEL, UTF-8 sequences as \x{XX}.
Whitespace is not normalized anymore like in versions <4.0.
@@ -28,26 +22,9 @@ Note for Users Upgrading to SpamAssassin
- AskDNS: tag HEADER(hdrname) supported to query any header content
similarly to header rules
-- Due to the dangerous nature of sa-update --allowplugins option, it
- now prints a warning that --reallyallowplugins is required to use it.
- This is to make sure all the legacy installations and wiki guides etc
- still using it needlessly get fixed.
-
- HashCash module and support has been removed completely, as it has been
long since deprecated
-- TxRep and Awl plugins has been modified to be compatible
- with latest Postgresql versions.
- You should upgrade your sql database running the following command:
- MySQL:
- "ALTER TABLE `txrep` CHANGE `count` `msgcount` INT(11) NOT NULL DEFAULT '0';"
- "ALTER TABLE `awl` CHANGE `count` `msgcount` INT(11) NOT NULL DEFAULT '0';"
- "ALTER TABLE `awl` ADD last_hit timestamp NOT NULL default CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;"
- PostgreSQL:
- "ALTER TABLE txrep RENAME COLUMN count TO msgcount;"
- "ALTER TABLE awl RENAME COLUMN count TO msgcount;"
- "ALTER TABLE awl ADD last_hit timestamp NOT NULL default CURRENT_TIMESTAMP;"
-
- URILocalBL: uri_block_cc/uri_block_cont support negation (Bug 7528)
- URILocalBL: uri_block_cidr "10.1.1.0-10.1.1.225" range format not
@@ -67,9 +44,6 @@ Note for Users Upgrading to SpamAssassin
- freemail_import_whitelist_auth, freemail_import_def_whitelist_auth added (Bug 6451)
-- body_part_scan_size 50000, rawbody_part_scan_size 500000 defaults added (Bug 6582)
- These enable safer and faster scanning of large emails.
-
- New internal Mail::SpamAssassin::GeoDB module that provides unified interface to
modules MaxMind::DB::Reader (GeoIP2), Geo::IP, IP::Country::DB_File, IP::Country::Fast.
Utilized by RelayCountry and URILocalBL. Settings geodb_module, geodb_options,
@@ -77,9 +51,6 @@ Note for Users Upgrading to SpamAssassin
uri_country_db_path, uri_country_db_isp_path still work but print a warning to
migrate to geodb_module/options.
-- RelayCountry: Added new metadata: X-Spam-Countries-External (_RELAYCOUNTRYEXT_),
- X-Spam-Countries-Auth (_RELAYCOUNTRYAUTH_), X-Spam-Countries-All (_RELAYCOUNTRYALL_)
-
- new plugin callback method check_cleanup
- Razor2 razor_fork option added. It will fork separate Razor2 process and
@@ -117,37 +88,85 @@ Note for Users Upgrading to SpamAssassin
- New AuthRes module to process Authentication-Results headers (unfinished)
+- Support GeoDB for ASN lookups (asn_use_geodb, asn_prefer_geodb, asn_use_dns).
+
+- sa-update: New --score-multiplier, --score-limit options
+
+- New dns_options nov4, nov6 (must set nov6 if resolver is filtering AAAA
+ replies).
+
+- API: Added Message::get_pristine_body_digest(), Message::get_msgid(),
+ Message::generate_msgid() functions, removed deprecated private
+ Plugin::Bayes::get_msgid() function.
+
+- Bayes and TxRep seen (Message-ID tracking) hashing method changed.
+ No actions are required. If re-learning some old messages, they might
+ be learned twice. Old IDs should expire automatically.
+
+Note for Users Upgrading to SpamAssassin 3.4.3
+----------------------------------------------
+
+- New subjprefix keyword added, this can be used to add a prefix to
+ email Subject if the original email matches a particular rule
+
+- New Util::is_fqdn_valid() function to validate hostname (DNS name) format
+ (Bug 7736). To check if a name contains valid TLD, it's still needed to
+ additionally use RegistryBoundaries::is_domain_valid()
+
- New OLEVBMacro plugin to detect OLE Macro inside documents attached to emails,
this plugin requires Archive::Zip and IO::String Perl modules to work.
-- HashBL: Add check_hashbl_bodyre, check_hashbl_emails, check_hashbl_uris,
- hashbl_ignore
+- Due to the dangerous nature of sa-update --allowplugins option, it
+ now prints a warning that --reallyallowplugins is required to use it.
+ This is to make sure all the legacy installations and wiki guides etc
+ still using it needlessly get fixed.
+
+- TxRep and Awl plugins has been modified to be compatible
+ with latest Postgresql versions.
+ You should upgrade your sql database running the following command:
+ MySQL:
+ "ALTER TABLE `txrep` CHANGE `count` `msgcount` INT(11) NOT NULL DEFAULT '0';"
+ "ALTER TABLE `awl` CHANGE `count` `msgcount` INT(11) NOT NULL DEFAULT '0';"
+ "ALTER TABLE `awl` ADD last_hit timestamp NOT NULL default CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;"
+ PostgreSQL:
+ "ALTER TABLE txrep RENAME COLUMN count TO msgcount;"
+ "ALTER TABLE awl RENAME COLUMN count TO msgcount;"
+ "ALTER TABLE awl ADD last_hit timestamp NOT NULL default CURRENT_TIMESTAMP;"
+
+- body_part_scan_size 50000, rawbody_part_scan_size 500000 defaults added (Bug 6582)
+ These enable safer and faster scanning of large emails.
+
+- ALL pseudo-header now returns decoded headers, so it's usage is consistent
+ with single header matching (:raw returns undecoded and folded like before).
+
+- RegistryBoundaries did not load 20_aux_tlds.cf properly in older versions.
+ Old hardcoded list is now removed and RB will print "no tlds defined, need
+ to run sa-update" unless it can find list from config files.
+
+- Deprecated functions: Parser::is_delimited_regexp_valid(),
+ Parser::is_regexp_valid(), Util::regexp_remove_delimiters(),
+ Util::make_qr(). These all are combined into new Util::compile_regexp().
- DNSEval: add check_rbl_headers to check specific headers in rbl
-- DNSEval: add check_rbl_ns_from to check against an rbl for dns serv
+- DNSEval: add check_rbl_ns_from to check against an rbl for dns servers
-- ASN: Support IPv6 with asn_lookup_ipv6 (Bug 7211). Support GeoDB for ASN
- lookups (asn_use_geodb, asn_prefer_geodb, asn_use_dns).
+- HashBL: Add check_hashbl_bodyre, check_hashbl_emails, check_hashbl_uris,
+ hashbl_ignore
-- sa-update: New option --httputil to force used download utility
+- ASN: Support IPv6 with asn_lookup_ipv6 (Bug 7211)
-- sa-update: New --score-multiplier, --score-limit options
+- sa-update: New option --httputil to force used download utility
- Add rules_matching() expression to meta rules
- Add tflags domains_only/ips_only to DNSEval.pm functions
-- New dns_options nov4, nov6 (must set nov6 if resolver is filtering AAAA
- replies).
-
-- API: Added Message::get_pristine_body_digest(), Message::get_msgid(),
- Message::generate_msgid() functions, removed deprecated private
- Plugin::Bayes::get_msgid() function.
+- RelayCountry: Added new metadata: X-Spam-Countries-External (_RELAYCOUNTRYEXT_),
+ X-Spam-Countries-Auth (_RELAYCOUNTRYAUTH_), X-Spam-Countries-All (_RELAYCOUNTRYALL_)
-- Bayes and TxRep seen (Message-ID tracking) hashing method changed.
- No actions are required. If re-learning some old messages, they might
- be learned twice. Old IDs should expire automatically.
+- New tflag "nosubject" for 'body' rules, to stop matching the Subject
+ header which is part of the body text.
Note for Users Upgrading to SpamAssassin 3.4.2
----------------------------------------------