razor-agent.conf(5)
Configuration file for Razor Agents
DESCRIPTION
"razor-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.
ATTRIBUTES
Following attributes can be specified:
- razorhome
-
Directory where Razor Agents look for files. All files in "razor-agent.conf"
without a full path will be relative to "razorhome".
The default is "/etc/razor/" for root, and "~/.razor/" for every other
user. If "razorhome" does not exist, it will be created.
- logfile
-
Log file for the Razor Agents. The default is "razor-agent.log".
- debuglevel
-
Controls the amount of messages written to logfile. It is an integer between
0 and 20. For Example, a value of 1 logs only startup
and error messages, 5 includes every transaction with the server,
and 14 is extremely verbose information intended for debugging use only.
NOTE: 15 and higher create debug files on your filesystem --- do not use unless you
know what you are doing.
The default is 5.
- 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, "<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 "servers.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 "servers.catalogue.lst".
- listfile_discovery
-
File where Razor Discovery Servers are listed, in random order.
This file is created automatically using DNS.
The default is "servers.discovery.lst".
- rediscovery_wait_dns
-
Max time in seconds Razor Agents will wait before computing a new
"listfile_discovery" using DNS.
The default is 604800, which is 7 days.
- rediscovery_wait
-
Max time in seconds Razor Agents will wait before computing a new
"listfile_nomination" and a new "listfile_catalogue".
The default is 172800, which is 2 days.
- turn_off_discovery
-
Turns off closest host discovery. When set to 1, "listfile_catalogue"
and "listfile_nomination" will not be updated and "listfile_discovery"
is not read or updated. The default is 0.
- ignorelist
-
Automatically ignore mailing list posts. If set to 0, mailing
list posts will be handled like all other mail.
The default is 0.
- 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 "razor-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 "min_cf". "min_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 "ac".
- report_headers
-
When reporting spam, the entire email (headers and body) is sent to
a Razor Nomination Server. When set to 0, all the headers are
removed except headers beginning with "Content-" before sending,
and a special header beginning with "X-Razor2" is added to note this action.
The default is 1.
