NAME

razor-report - Razor Reporting Agent

SYNOPSIS 

	cat spamfile | razor-report

DESCRIPTION

razor-report is the Razor Reporting Agent which is used for reporting spam messages to a Razor Catalogue Server. razor-report should be generally called from a MUA, although there are no restrictions on invoking it from the command-line. razor-report is a filter, which means that spam messages should be piped through it. By default, razor-report backgrounds and detaches itself from the control terminal at start-up.

USAGE

razor-report takes following arguments:

-s
Simulate only. Don't talk to the server.
-f
Stay in foreground.
-d
Print debugging information.
-H
Compute and print the SHA hash of the mail contents. And then exit.
-M | --mbox

Accept a mailbox name on the command line and report every mail in the mailbox against the database. razor-report will print out the serial number of every mail that was accepted by the Catalogue server. Please use this option with utmost caution. You don't want to fill up the Catalogue with non-spam signatures. 

 razor-report -M ~/Mail/todays-spam
-S | --sig
Accept a list of pre-computed (with -H) signatures on the command line, instead of computing one from mail content. When called with --sig, razor-report will not attempt to read from STDIN. Usage: razor-report -d -sig a8a3d545adb73f9733675571ffeaf10cba87745b
-conf=filename
The path of the config file. By default the path is ~/razor.conf, an alternate path can be specified with this option. See razor.conf(5) manpage for various configuration options.
-h
Print a usage message and exit.
-v
Print the version number and exit.

INTEGRATION WITH MUTT

Add the following line to mutt.conf 

     macro index S "|/usr/bin/razor-report"

Then press S on the spam message in mutt to report it with razor-report. Since razor-report forks, the control will return immediately.

SETTING UP A TROLLBOX

By replying to spammers from an address that you don't use for legit communications, you can build troll addresses that gather spam. When you reply to spammers they usually add the "From" address in your reply to their mailing lists. Eventually this address will start getting spammed. Other ways of building troll boxes is to post to USENET from troll addresses, or embed them in your webpages. Mail destined to these addresses should be directly fed to razor-report via procmail(1) or a similar mail processor.

If foo-spam@bar.com is your troll address, you would use the following procmail recipe to automatically report spam: 

    :0 W
    * ^To: foo-spam@bar.com
    | /usr/bin/razor-report

Troll boxes are also useful for reporting spam from machines where razor-report is not available. Simply bounce the message to your troll address and it will be reported via razor-report.

The following macro can be used to bounce a spam to a troll box from mutt by pressing the `S' key. 

    macro index S "b foo-spam@bar.com^Myd"

where a literal ^M is typed as Ctrl-V + Ctrl-M.

AUTHOR

Vipul Ved Prakash, <mail@vipul.net>

SEE ALSO

razor.conf(5), razor-check(1), razor-discover(1)

LICENSE

This is free software, distributed under the ARTISTIC license.