1Mail::SpamAssassin::PluUgsienr::CDoCnCt(r3i)buted Perl DMoaciulm:e:nStpaatmiAosnsassin::Plugin::DCC(3)
2
6 Mail::SpamAssassin::Plugin::DCC - perform DCC check of messages
7
9 loadplugin Mail::SpamAssassin::Plugin::DCC
10 full DCC_CHECK eval:check_dcc()
12 full DCC_CHECK_50_79 eval:check_dcc_reputation_range('50','79')
13
15 The DCC or Distributed Checksum Clearinghouse is a system of servers
16 collecting and counting checksums of millions of mail messages.
17 TheSpamAssassin.pm counts can be used by SpamAssassin to detect and
18 reject or filter spam.
19 Because simplistic checksums of spam can be easily defeated, the main
21 DCC checksums are fuzzy and ignore aspects of messages. The fuzzy
22 checksums are changed as spam evolves.
23 Note that DCC is disabled by default in "init.pre" because it is not
25 open source. See the DCC license for more details.
26 See http://www.rhyolite.com/anti-spam/dcc/ for more information about
28 DCC.
29
31 The following tags are added to the set, available for use in reports,
32 header fields, other plugins, etc.:
33 _DCCB_ DCC server ID in a response
35 _DCCR_ response from DCC - header field body in X-DCC-*-Metrics
36 _DCCREP_ response from DCC - DCC reputation in percents (0..100)
37 Tag _DCCREP_ provides a nonempty value only with commercial DCC
39 systems. This is the percentage of spam vs. ham sent from the first
40 untrusted relay.
41
43 use_dcc (0|1) (default: 1)
44 Whether to use DCC, if it is available.
45 dcc_body_max NUMBER
47 dcc_fuz1_max NUMBER
48 dcc_fuz2_max NUMBER
49 This option sets how often a message's body/fuz1/fuz2 checksum must
50 have been reported to the DCC server before SpamAssassin will
51 consider the DCC check as matched.
52 As nearly all DCC clients are auto-reporting these checksums, you
54 should set this to a relatively high value, e.g. 999999 (this is
55 DCC's MANY count).
56 The default is 999999 for all these options.
58 dcc_rep_percent NUMBER
60 Only commercial DCC systems provide DCC reputation information.
61 This is the percentage of spam vs. ham sent from the first
62 untrusted relay. It will hit on new spam from spam sources.
63 Default is 90.
64
66 dcc_timeout n (default: 8)
67 How many seconds you wait for DCC to complete, before scanning
68 continues without the DCC results.
69 dcc_home STRING
71 This option tells SpamAssassin where to find the dcc homedir. If
72 not given, it will try to get dcc to specify one, and if that fails
73 it will try dcc's own default homedir of '/var/dcc'. If "dcc_path"
74 is not specified, it will default to looking in "dcc_home/bin" for
75 dcc client instead of relying on SpamAssassin to find it in the
76 current PATH. If it isn't found there, it will look in the current
77 PATH. If a "dccifd" socket is found in "dcc_home" or specified
78 explicitly, it will use that interface instead of "dccproc".
79 dcc_dccifd_path STRING
81 This option tells SpamAssassin where to find the dccifd socket. If
82 "dcc_dccifd_path" is not specified, it will default to looking for
83 a socket named "dccifd" in a directory "dcc_home". The
84 "dcc_dccifd_path" can be a Unix socket name (absolute path), or an
85 INET socket specification in a form "[host]:port" or "host:port",
86 where a host can be an IPv4 or IPv6 address or a host name, and
87 port is a TCP port number. In case of an IPv6 address the brackets
88 are required syntax. If a "dccifd" socket is found, the plugin will
89 use it instead of "dccproc".
90 dcc_path STRING
92 This option tells SpamAssassin specifically where to find the
93 "dccproc" client instead of relying on SpamAssassin to find it in
94 the current PATH. Note that if taint mode is enabled in the Perl
95 interpreter, you should use this, as the current PATH will have
96 been cleared.
97 dcc_options options
99 Specify additional options to the dccproc(8) command. Please note
100 that only characters in the range [0-9A-Za-z ,._/-] are allowed for
101 security reasons.
102 The default is "undef".
104 dccifd_options options
106 Specify additional options to send to the dccifd(8) daemon. Please
107 note that only characters in the range [0-9A-Za-z ,._/-] are
108 allowed for security reasons.
109 The default is "undef".
111perl v5.10.1 2010-03-16Mail::SpamAssassin::Plugin::DCC(3)