CWrazor-agent.conf - Configuration file for Razor Agents

CWrazor-agent.conf is a configuration file read by the razor agents, which include razor-check(1), razor-admin(1), razor-report(1), and razor-revoke(1). The format is attribute = value pairs, one pair per line. Lines that begin with `#' are treated as comments.

Following attributes can be specified:

razorhome

Directory where Razor Agents look for files. All files in CWrazor-agent.conf without a full path will be relative to CWrazorhome. The default is CW/etc/razor/ for root, and CW~/.razor/ for every other user. If CWrazorhome does not exist, it will be created.

logfile

Log file for the Razor Agents. The default is CWrazor-agent.log.

debuglevel

Controls the amount of messages written to logfile. It is an integer between 0 and 20. For Example, a value of CW1 logs only startup and error messages, CW5 includes every transaction with the server, and CW14 is extremely verbose information intended for debugging use only. NOTE: CW15 and higher create debug files on your filesystem do not use unless you know what you are doing. The default is CW5.

identity

Specify an identify file to use for storing a newly registered identity during razor-admin(1). For razor-report(1) and razor-revoke(1), use this identity when authenticating with Razor Servers. If not specified, CW<razorhome>/identity-<user> is used.

listfile_nomination

File where Razor Nomination Servers are listed, in order of closest TCP ping time. Nomination Servers are used by razor-report(1) and razor-revoke(1). This file is created automatically. The default is CWservers.nomination.lst.

listfile_catalogue

File where Razor Catalogue Servers are listed, in order of closest TCP ping time. Catalogue Servers are used by razor-check(1). This file is created automatically. The default is CWservers.catalogue.lst.

listfile_discovery

File where Razor Discovery Servers are listed, in random order. This file is created automatically using DNS. The default is CWservers.discovery.lst.

rediscovery_wait_dns

Max time in seconds Razor Agents will wait before computing a new CWlistfile_discovery using DNS. The default is CW604800, which is 7 days.

rediscovery_wait

Max time in seconds Razor Agents will wait before computing a new CWlistfile_nomination and a new CWlistfile_catalogue. The default is CW172800, which is 2 days.

turn_off_discovery

Turns off closest host discovery. When set to 1, CWlistfile_catalogue and CWlistfile_nomination will not be updated and CWlistfile_discovery is not read or updated. The default is CW0.

ignorelist

Automatically ignore mailing list posts. If set to CW0, mailing list posts will be handled like all other mail. The default is CW0.

whitelist

Name of whitelist file. Razor Agents can consult a whitelist of addresses and SHA1 hashes before checking a mail with Razor Servers. If the address/hash is found on the whitelist, the mail is marked `not spam', without checking against the server. The format of the whitelist can be found in razor-whitelist(5) manpage. The default is CWrazor-whitelist.

min_cf

When checking spam, the server optionally returns a spam confidence value ranging from 0 (not confident) to 100 (absolutely or 100% confident). To be considered spam, the server's spam confidence value must be greater than or equal to CWmin_cf. CWmin_cf can be a number or an expression containing ac, the average confidence published by a Razor Server. Examples: 0, 60, 100, ac, ac + 10, ac - 20. If an expression evaluates to less than 0 it becomes 0, likewise those greater than 100 become 100. The default is CWac.

report_headers

When reporting spam, the entire email (headers and body) is sent to a Razor Nomination Server. When set to CW0, all the headers are removed except headers beginning with CWContent- before sending, and a special header beginning with CWX-Razor2 is added to note this action. The default is CW1.

Vipul Ved Prakash, <mail@vipul.net> and Chad Norwood <chad@samo.org>

razor-agents(1), razor-check(1), razor-admin(1), razor-report(1), razor-revoke(1), razor-whitelist(5)