NAME

blogspam - An RPC server for testing blog comments

SYNOPSIS

  blogspam [options]

  Path Options:

   --state       Specify the path to the state directory.

  Cache Cleanup Options:

   --hourly      Run hourly tasks.
   --daily       Run daily tasks.
   --weekly      Run weekly tasks.

  Help Options:

   --help        Show the help information for this script.
   --manual      Read the manual for this script.
   --verbose     Show useful debugging information.

OVERVIEW

The blogspam server makes use of the Blog::Spam::Server module to present an XML-RPC server for the use of testing comments for spam.

It is ideally suited for small and medium sized blogs, forums, and similar sites which accept comments from users and which may be attacked by the submission of spam comments.

ABOUT

This script is designed to be started by a non-privileged user, where it will launch an RPC::XML::Server instance listening upon the network. By default port 8888 will be used,but this may be changed via the appropriate command line option.

All state will be stored in the home directory of the user s-blogspam if it exists upon the local system, otherwise in the current working directory beneath a directory named state/.

In order to ensure that scheduled tasks are completed it is strongly recommended you add crontab entries, running as the launcher, to run three jobs:

    # blogspam entries to clear caches, etc.

    17 * * * *  s-blogspam  /usr/local/bin/blogspam --hourly
    20 6 * * *  s-blogspam  /usr/local/bin/blogspam --daily
    25 6 1 * *  s-blogspam  /usr/local/bin/blogspam --weekly

AUTHOR

Steve Kemp: http://www.steve.org.uk/

LICENSE

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.