Provided by: razor_2.85-3_i386 bug

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)