NAME

Net::Peep::Parse - Perl extension for parsing configuration files for Peep: The Network Auralizer.

SYNOPSIS

use Net::Peep::Parse;
my $parser = new Net::Peep::Parse;

# loadConfig returns a Net::Peep::Conf object

my $config = $parser->loadConfig(
                                 config => '/usr/local/etc/peep.conf', 
                                 app => 'logparser'
);

# all of the configuration information in /etc/peep.conf
# is now available through the observer methods in the
# Net::Peep::Conf object

DESCRIPTION

Net::Peep::Parse parses a Peep configuration file and returns a Net::Peep::Conf object whose accessors contain all the information found in the configuration file.

EXPORT

None by default.

METHODS

loadConfig(%options) - loads configuration information found in the
file $options{'config'} for application $options{'app'}.  Returns a
Net::Peep::Conf object.

parseConfig($config) - parses the configuration file $config.

parseClass($filehandle,$classname) - parses the class definition
section of a configuration file.

parseClient($filehandle,$client) - parses the client definition
section of a configuration file.

parseEvents($filehandle) - parses the event definition section of a
configuration file.

parseState($filehandle) - parses the state definition section of a
configuration file.

parseClientEvents($filehandle) - parses the client event definition
section of a configuration file.

parseClientDefault($filehandle) - parses the client defaults section
of a configuration file.

logger() - returns a Net::Peep::Log object for logging and
debugging.

configObject() - returns a Net::Peep::Conf object for storing and
retrieving configuration information.

AUTHOR

Collin Starkweather <collin.starkweather@colorado.edu> Copyright (C) 2001

SEE ALSO

perl(1), peepd(1), Net::Peep::BC, Net::Peep::Log, Net::Peep::Conf.

http://peep.sourceforge.net

CHANGE LOG

$Log: Parse.pm,v $ Revision 1.2 2001/05/07 02:39:19 starky A variety of bug fixes and enhancements: o Fixed bug 421729: Now the --output flag should work as expected and the --logfile flag should not produce any unexpected behavior. o Documentation has been updated and improved, though more improvements and additions are pending. o Removed print STDERRs I'd accidentally left in the last commit. o Other miscellaneous and sundry bug fixes in anticipation of a 0.4.2 release.

Revision 1.1 2001/04/23 10:13:19 starky Commit in preparation for release 0.4.1.

o Altered package namespace of Peep clients to Net::Peep at the suggestion of a CPAN administrator. o Changed Peep::Client::Log to Net::Peep::Client::Logparser and Peep::Client::System to Net::Peep::Client::Sysmonitor for clarity. o Made adjustments to documentation. o Fixed miscellaneous bugs.

Revision 1.6 2001/03/31 07:51:35 mgilfix

Last major commit before the 0.4.0 release. All of the newly rewritten
clients and libraries are now working and are nicely formatted. The server
installation has been changed a bit so now peep.conf is generated from
the template file during a configure - which brings us closer to having
a work-out-of-the-box system.

Revision 1.6 2001/03/31 02:17:00 mgilfix Made the final adjustments to for the 0.4.0 release so everything now works. Lots of changes here: autodiscovery works in every situation now (client up, server starts & vice-versa), clients now shutdown elegantly with a SIGTERM or SIGINT and remove their pidfiles upon exit, broadcast and server definitions in the class definitions is now parsed correctly, the client libraries now parse the events so they can translate from names to internal numbers. There's probably some other changes in there but many were made :) Also reformatted all of the code, so it uses consistent indentation.

Revision 1.5 2001/03/28 02:54:20 starky Fixed a bug in the regex in the parseClientHosts method.

Revision 1.4 2001/03/28 02:41:48 starky Created a new client called 'pinger' which pings a set of hosts to check whether they are alive. Made some adjustments to the client modules to accomodate the new client.

Also fixed some trivial pre-0.4.0-launch bugs.

Revision 1.3 2001/03/27 00:44:19 starky Completed work on rearchitecting the Peep client API, modified client code to be consistent with the new API, and added and tested the sysmonitor client, which replaces the uptime client.

This is the last major commit prior to launching the new client code, though the API or architecture may undergo some initial changes following launch in response to comments or suggestions from the user and developer base.

Revision 1.2 2001/03/18 17:17:46 starky Finally got LogParser (now called logparser) running smoothly.

Revision 1.1 2001/03/16 18:31:59 starky Initial commit of some very broken code which will eventually comprise a rearchitecting of the Peep client libraries; most importantly, the Perl modules.

A detailed e-mail regarding this commit will be posted to the Peep develop list (peep-develop@lists.sourceforge.net).

Contact me (Collin Starkweather) at

collin.starkweather@colorado.edu

or

collin.starkweather@collinstarkweather.com

with any questions.