NAME¶
"razor-agent.conf" - 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.
AUTHORS¶
Vipul Ved Prakash, <mail@vipul.net> and Chad Norwood <chad@samo.org>
SEE ALSO¶
razor-agents(1),
razor-check(1),
razor-admin(1),
razor-report(1),
razor-revoke(1),
razor-whitelist(5)