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:
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
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 firstplugins.ini
ornagios-plugins.ini
file found will be used.
SEE ALSO
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.