The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

kiboze.pl - a news archiving 'bot

SYNOPSIS

kiboze.pl [-hvd] [-V] [-Q] [-n newsrcfile] [-s newsserver]

DESCRIPTION

This script connects to a news server (or set of servers) and archives the newsgroups specified in a newsrc file. This can be used to save entire newsgroups for later searches, just message archiving.

USAGE

Without any options, kiboze.pl will connect to each of the news servers specified in turn, and attempt to download up to 1000 articles (or whatever the current value of $MAXARTS is).

-h

Prints a short help message and exits.

-v

Prints the version number and exits.

-d

Prints out the script defaults and exits.

-V

Verbose mode. Prints out some basic status messages when they are necessary. More information is available in debugging mode, but you probably don't want to read it.

-Q

Quiet mode. Never prints anything out. This is handy if you're putting the script into a cron job and don't want to look over any logs; on the other hand, most of what it blocks is error messages anyway, so you might want to have them in your mailbox.

-s newsserver

Specifies which news server to connect to. This may be used to connect to just one server out of a set. If combined with the -n flag, you can also connect to servers not present in the script.

-n newsrcfile

Specifies which newsrc to use. If this newsrc is already used by a server, then it uses that information for the server; otherwise, the -s flag is required.

REQUIREMENTS

News::Newsrc, News::Article, and News::Archive.

Requires Perl 5.?? or better, News::Newsrc, and News::Article. All other requirements should be included automatically with Perl5.

TODO

Make some default newsrc files if one doesn't exist. Start using an active-file type dealie, to increase efficiency by a whole lot and allow the various servers to work together. Make some more scripts to search the cache file by message-id. Add locking stuff.

AUTHOR

Tim Skirvin <tskirvin@killfile.org>

COPYRIGHT

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

This code may be used and/or distributed under the same terms as Perl itself. Oh, and it's beta code, so use it at your own risk.