Nagios::Plugin::Config(3pm)				User Contributed Perl Documentation			       Nagios::Plugin::Config(3pm)

NAME

       Nagios::Plugin::Config - read nagios plugin .ini style config files

SYNOPSIS

	   # Read given nagios plugin config file
	   $Config = Nagios::Plugin::Config->read( '/etc/nagios/plugins.ini' );

	   # Search for and read default nagios plugin config file
	   $Config = Nagios::Plugin::Config->read();

	   # Access sections and properties (returns scalars or arrayrefs)
	   $rootproperty =  $Config->{_}->{rootproperty};
	   $one = $Config->{section}->{one};
	   $Foo = $Config->{section}->{Foo};

DESCRIPTION

       Nagios::Plugin::Config is a subclass of the excellent Config::Tiny, with the following changes:

       o   Repeated keys are allowed within sections, returning lists instead of scalars

       o   Write functionality has been removed i.e. access is read only

       o   Nagios::Plugin::Config searches for a default nagios plugins file if no explicit filename is given to "read()". The current standard
	   locations checked are:

	   /etc/nagios/plugins.ini
	   /usr/local/nagios/etc/plugins.ini
	   /usr/local/etc/nagios /etc/opt/nagios/plugins.ini
	   /etc/nagios-plugins.ini
	   /usr/local/etc/nagios-plugins.ini
	   /etc/opt/nagios-plugins.ini

	   To use a custom location, set a "NAGIOS_CONFIG_PATH" environment variable to the set of directories that should be checked. The first
	   "plugins.ini" or "nagios-plugins.ini" file found will be used.

SEE ALSO

       Config::Tiny, Nagios::Plugin

AUTHORS

       This code is maintained by the Nagios Plugin Development Team: <http://nagiosplug.sourceforge.net>.

COPYRIGHT and LICENCE
       Copyright (C) 2006-2007 by Nagios Plugin Development Team

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2010-12-03					       Nagios::Plugin::Config(3pm)