view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    App::Pocosi - A command line tool for launching a
    POE::Component::Server::IRC instance

DESCRIPTION
    This distribution provides a generic way to launch a
    POE::Component::Server::IRC instance.

    *   Prints useful status information (to your terminal and/or a log
        file)

    *   Will daemonize if you so wish

    *   Supports a configuration file

    *   Offers a user friendly way to pass arguments to
        POE::Component::Server::IRC

    *   Has an interactive mode where you can issue issue commands and call
        methods on the IRCd component.

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:
         - "Welcome to this great server"
         - ""
         - "Enjoy your stay"

     plugins:
       - [OperServ]

     listeners:
       - bindaddr: "127.0.0.1"
         port:     10023

     denials:
       - ["12.34.56.0/24", "I don't like this IP block"]

     exemptions:
       - "12.34.56.78"

     operators:
       - username: jack
         password: foo
         ipmask:   ["127.0.0.1", "1.2.3.4", "192.168.1.0/24"]
       - username: locke
         password: bar
         ipmask:   "10.0.0.*"

     auths:
       - mask:     "*@example.com"
         password: hlagh
         spoof:    jacob
         no_tilde: true

     peers:
       - name:     otherserver.com
         rpass:    hlaghpass
         pass:     hlaghpass
         type:     r
         raddress: "127.0.0.1"
         rport:    12345
         auto:     true

    The configuration file is in YAML or JSON format. It consists of a hash
    containing the options described in the above code example. Only
    "config" is required.

  "lib"
    Either the name of a directory containing Perl modules (e.g. plugins),
    or an array of such names. Kind of like Perl's *-I*.

  "pid_file"
    Path to a pid file, as used by most daemons. If is specified,
    App::Pocosi will refuse to run if the file already exists.

  "log_file"
    Path to a log file to which status messages will be written.

  "class"
    The IRC server component class. Defaults to
    POE::Component::Server::IRC::State.

  "config"
    This is a hash of various configuration variables for the IRCd. See
    PoCo-Server-IRC's "configure" for a list of parameters.

  "plugins"
    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::*YourPlugin* before trying to
    load *YourPlugin*.