App-pocosi is a project mainly written in Perl, it's free.
A command line tool for launching a POE::Component::Server::IRC instance
=encoding utf8
=head1 NAME
App::Pocosi - A command line tool for launching a POE::Component::Server::IRC instance
=head1 DESCRIPTION
This distribution provides a generic way to launch a L<POE::Component::Server::IRC|POE::Component::Server::IRC> instance.
=over 4
=item * Prints useful status information (to your terminal and/or a log file)
=item * Will daemonize if you so wish
=item * Supports a configuration file
=item * Offers a user friendly way to pass arguments to POE::Component::Server::IRC
=item * Has an interactive mode where you can issue issue commands and call methods on the IRC component(s).
=back
=head1 CONFIGURATION
class: POE::Component::Server::IRC log_file: /my/log.file pid_file: /my/pid.file lib: /my/modules flood: false auth: true
config: servername: myserver.com motd:
plugins:
listeners:
denials:
exemptions:
operators:
auths:
peers:
The configuration file is in L<YAML|YAML> or L<JSON|JSON> format. It consists
of a hash containing the options described in the above code example. Only
C
=head2 C
Either the name of a directory containing Perl modules (e.g. plugins), or an array of such names. Kind of like Perl's I<-I>.
=head2 C
Path to a pid file, as used by most daemons. If is specified, App::Pocosi will refuse to run if the file already exists.
=head2 C
Path to a log file to which status messages will be written.
=head2 C
The IRC server component class. Defaults to L<POE::Component::Server::IRC::State|POE::Component::Server::IRC::State>.
=head2 C
This is a hash of various configuration variables for the IRCd. See
PoCo-Server-IRC's L<C
=head2 C
An array of arrays containing a short plugin class name (e.g. 'OperServ')
and optionally a hash of arguments to that plugin. When figuring out the
correct package name, App::Pocosi will first try to load
POE::Component::Server::IRC::Plugin::I
=head2 C
An array of hashes. The keys should be any of the options listed in the docs
for PoCo-Server-IRC-Backend's
L<C
=head2 C
An array of hashes. The keys are described in the docs for PoCo-Server-IRC's
L<C
=head2 C
An array of hashes. The keys are described in the docs for PoCo-Server-IRC's
L<C
=head2 C
An array of hashes. The keys should be any of the options listed in the docs
for PoCo-Server-IRC's
L<C
=head2 C
An array of arrays. The first element of the inner array should be a netmask accepted by L<Net::Netmask|Net::Netmask>'s constructor. The second (optional) element should be a reason for the denial.
=head2 C
An array of netmasks (the kind which L<Net::Netmask|Net::Netmask>'s constructor accepts).
=head1 OUTPUT
Here is some example output from the program:
$ pocosi -f example/config.yml 2011-05-22 15:30:02 Started (pid 13191) 2011-05-22 15:30:02 Constructing plugins 2011-05-22 15:30:02 Spawning IRCd component (POE::Component::Server::IRC) 2011-05-22 15:30:02 Registering plugins 2011-05-22 15:30:02 Added plugin PocosiStatus_1 2011-05-22 15:30:02 Added plugin OperServ_1 2011-05-22 15:30:02 Started listening on 127.0.0.1:10023 2011-05-22 15:30:02 Connected to peer otherserver.com on 127.0.0.1:12345 2011-05-22 15:30:02 Server otherserver.com (hops: 1) introduced to the network by myserver.com ^C2011-05-22 15:30:18 Exiting due to SIGINT 2011-05-22 15:30:18 Deleted plugin OperServ_1 2011-05-22 15:30:18 Deleted plugin PocosiStatus_1 2011-05-22 15:30:18 IRC component shut down
=head1 AUTHOR
Hinrik E
=head1 LICENSE AND COPYRIGHT
Copyright 2011 Hinrik E
This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
=cut