NAME

Mail::SpamAssassin::Plugin::DCC - perform DCC check of messages


SYNOPSIS

  loadplugin     Mail::SpamAssassin::Plugin::DCC
  full DCC_CHECK        eval:check_dcc()
  full DCC_CHECK_50_79  eval:check_dcc_reputation_range('50','79')


DESCRIPTION

The DCC or Distributed Checksum Clearinghouse is a system of servers collecting and counting checksums of millions of mail messages. TheSpamAssassin.pm counts can be used by SpamAssassin to detect and reject or filter spam.

Because simplistic checksums of spam can be easily defeated, the main DCC checksums are fuzzy and ignore aspects of messages. The fuzzy checksums are changed as spam evolves.

Note that DCC is disabled by default in init.pre because it is not open source. See the DCC license for more details.

See http://www.rhyolite.com/anti-spam/dcc/ for more information about DCC.


TAGS

The following tags are added to the set, available for use in reports, header fields, other plugins, etc.:

  _DCCB_    DCC server ID in a response
  _DCCR_    response from DCC - header field body in X-DCC-*-Metrics
  _DCCREP_  response from DCC - DCC reputation in percents (0..100)

Tag _DCCREP_ provides a nonempty value only with commercial DCC systems. This is the percentage of spam vs. ham sent from the first untrusted relay.


USER OPTIONS

use_dcc (0|1) (default: 1)

Whether to use DCC, if it is available.

dcc_body_max NUMBER
dcc_fuz1_max NUMBER
dcc_fuz2_max NUMBER

This option sets how often a message's body/fuz1/fuz2 checksum must have been reported to the DCC server before SpamAssassin will consider the DCC check as matched.

As nearly all DCC clients are auto-reporting these checksums, you should set this to a relatively high value, e.g. 999999 (this is DCC's MANY count).

The default is 999999 for all these options.

dcc_rep_percent NUMBER

Only commercial DCC systems provide DCC reputation information. This is the percentage of spam vs. ham sent from the first untrusted relay. It will hit on new spam from spam sources. Default is 90.


ADMINISTRATOR OPTIONS

dcc_timeout n (default: 8)

How many seconds you wait for DCC to complete, before scanning continues without the DCC results.

dcc_home STRING

This option tells SpamAssassin where to find the dcc homedir. If not given, it will try to get dcc to specify one, and if that fails it will try dcc's own default homedir of '/var/dcc'. If dcc_path is not specified, it will default to looking in dcc_home/bin for dcc client instead of relying on SpamAssassin to find it in the current PATH. If it isn't found there, it will look in the current PATH. If a dccifd socket is found in dcc_home or specified explicitly, it will use that interface instead of dccproc.

dcc_dccifd_path STRING

This option tells SpamAssassin where to find the dccifd socket. If dcc_dccifd_path is not specified, it will default to looking for a socket named dccifd in a directory dcc_home. The dcc_dccifd_path can be a Unix socket name (absolute path), or an INET socket specification in a form [host]:port or host:port, where a host can be an IPv4 or IPv6 address or a host name, and port is a TCP port number. In case of an IPv6 address the brackets are required syntax. If a dccifd socket is found, the plugin will use it instead of dccproc.

dcc_path STRING

This option tells SpamAssassin specifically where to find the dccproc client instead of relying on SpamAssassin to find it in the current PATH. Note that if taint mode is enabled in the Perl interpreter, you should use this, as the current PATH will have been cleared.

dcc_options options

Specify additional options to the dccproc(8) command. Please note that only characters in the range [0-9A-Za-z ,._/-] are allowed for security reasons.

The default is undef.

dccifd_options options

Specify additional options to send to the dccifd(8) daemon. Please note that only characters in the range [0-9A-Za-z ,._/-] are allowed for security reasons.

The default is undef.