NAME

google-gather - Leverage the power of Google(tm) to catch abuse complaints

SYNOPSIS

google-gather [-h] [-v] [-d delimiter] [-c count] [-m max] -s search

DESCRIPTION

One very important source of abuse complaints is the news group News.Admin.Net-Abuse.Sightings or NANAS. At NANAS, many activists place samples of abuse that are captured at remote sites and that, ideally, serve as an indication that corrections are needed.

google-gather fetches complaints from NANAS and produces an output suitable as input to abuso through the Mail::Abuse::Reader::Stdin module.

Do not abuse this script

In general, it is not polite to send large numbers of queries to a host, as this might be interpreted as an attack. This is true, even if said host is Google. Use this scipt judiciously and avoid long and repeated queries.

The following options are recognized:

-h

Outputs this documentation.

-v

Be verbose about progress.

-s search

What to search for. Typically, this should be your domain name.

-d delimiter

Text string used to separate reports. See Mail::Abuse::Reader::Stdin for an application of this delimiter. Defaults to ___END_OF_REPORT___.

-c count

How many reports to extract from NANAS. No more than this number of reports will be processed. Defaults to 20.

-m max count

The maximum number of articles that will be spidered by this script. Defaults to 1000.

The complaint should be fed through STDIN, as the output of acat would.

HISTORY

Jan, 2004

First version of this code.

LICENSE AND WARRANTY

This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the same terms as Perl itself.

AUTHOR

Luis E. Muñoz <luismunoz@cpan.org>

SEE ALSO

perl(1), acat(1), WWW::Mechanize(3)