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:

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

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

  • Nagios::Plugin::Config searches for a default nagios plugins file if no explicit filename is given to \*(C`read()\*(C'. 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 \*(C`NAGIOS_CONFIG_PATH\*(C' environment variable to the set of directories that should be checked. The first \*(C`plugins.ini\*(C' or \*(C`nagios-plugins.ini\*(C' file found will be used.

RELATED TO Nagios::Plugin::Config…

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.