NAME

pgpmoose - a cancelbot for policing moderated newsgroups

SYNOPSIS

  pgpmoose [-hvVt] [-l] [-a] [-sucg group] [-n newsrc] [-S server]

        -h              Print this usage information and exit.
        -v              Print version information and exit.
        -V              Verbose mode.  Print information on every article.
        -t              Testing mode.  Do not actually cancel anything,
                          just confirm them for our own satisfaction.
        -n newsrc       .newsrc file from which to load the newsgroups.
        -S newsserver   Newsserver to connect to 
        -a              Work with all newsgroups
        -g newsgroup    Only work with this group
        -s newsgroup    Subscribe to the specified newsgroup (and exit)
        -u newsgroup    Unsubscribe to the specified newsgroup (and exit)
        -c newsgroup    Clear the specified newsgroup (and exit)
        -C configfile   Use this configuration file instead of $LOCALCONF 
                          (generally $ENV{'HOME'}/.pgpmooserc)

DESCRIPTION

pgpmoose is a program that cancels invald messages from moderated Usenet groups. All messages to a specific group are assumed to have a PGP signature added at injection by the newsgroup moderator; if no such signature exists, or if the signature is invalid for the stated moderator of the group, then the message is assumed to be invalid. This program takes care of actually issuing the cancels for those messages.

NOTES

This is essentially a wrapper for News::Article's verify_pgpmoose() and the News::Article::Cancel module. You shouldn't be running this unless you're moderating a newsgroup and have a really good idea of how Usenet works. Really. Even then, watch the logs carefully, and be prepared for a lot of headache.

Note that cancels are tricky things, and I hold no responsiblity for what you use this thing for.

You must configure this program to make it work, either with $LOCALCONF or by modifying the program directly. This is intentional. A sample configuration file is distributed with the program; track it down if you really want to use it.

REQUIREMENTS

Perl 5, News::Article::Cancel (which requires News::Article), Net::NNTP::Auth (which requires Net::NNTP), News::Newsrc. Some of these modules probably require a Unix system.

SEE ALSO

News::Article::Cancel, News::Article, Net::NNTP::Auth, the Cancel FAQ (http://www.killfile.org/faqs/cancel.html)

Software can be downloaded from http://www.killfile.org/~tskirvin/software/pgpmoose/

AUTHOR

Tim Skirvin <tskirvin@killfile.org>

LICENSE

This code may be redistributed under the same terms as Perl itself.

The author holds no responsibility for how this program is used, save to note that it can probably be misused rather easily; please don't do so, though.

COPYRIGHT

Copyright 1999-2004, Tim Skirvin <tskirvin@killfile.org>.