


Nagios::Plugin:UserfContributed Perl DoNagios::Plugin::Config(3p)


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.12.2                2009-03-18                          1


