The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Bot-CPAN-1.11
++
/ cpanbot

NAME

cpanbot - wrapper script for Bot::CPAN

SYNOPSIS

 # start the bot, using a config file
 $ cpanbot &
 # same as above, plus log all output to /tmp/cpanbot
 $ cpanbot >>/tmp/cpanbot 2>&1 &
 # start the bot, using a config file, adding two servers
 $ cpanbot --servers=grou.ch,binky.rhizomatic.net &
 # same as above, plus log all output to /tmp/cpanbot
 $ cpanbot --servers=grou.ch,binky.rhizomatic.net >>/tmp/cpanbot 2>&1 &

DESCRIPTION

cpanbot is a wrapper around Bot::CPAN that takes a configuration file and optional command-line arguments.

The config file is expected to reside at one of the following locations:

cpanbotconfig ~/cpanbotconfig /etc/cpanbotconfig cpanbot.config ~/cpanbot.config /etc/cpanbot.config cpanbotrc ~/cpanbotrc /etc/cpanbotrc .cpanbotrc ~/.cpanbotrc /etc/.cpanbotrc

VALID OPTIONS

Single value options: port, nick, username, name, reload_indices_interval, inform_channel_of_new_uploads, debug, search_max_results, adminhost, news_server, group

Multiple value options: channels, servers, alt_nicks, ignore_list

EXAMPLE CONFIG

 channels #cpan
 channels #poe
 servers irc.perl.org
 servers binky.rhizomatic.net
 servers london.rhizomatic.net
 servers bullfrog.rhizomatic.net
 servers token.rhizomatic.net
 port 6667
 nick cpantest
 alt_nicks cpantest2
 alt_nicks cpantest3
 username cpantest
 name cpantest
 ignore_list purl
 ignore_list shorten
 reload_indices_interval 300
 inform_channel_of_new_uploads 60
 debug 0
 search_max_results 20
 adminhost qr/Fox!~Snak\@12-226-101-175\.client\.attbi\.com/
 news_server nntp.perl.org
 group perl.cpan.testers
 policy #poe allow qr/^POE-/i
 policy #poe deny qr/.+/

COPYRIGHT

  Copyright (c) 2003 Adam J. Foxson. All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

AUTHOR

Adam J. Foxson <afoxson@pobox.com>