---
name: "Monitoring::Plugin::Config"
section: "3pm"
platform: "linux"
package: "libmonitoring-plugin-perl"
version: "0.40-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Monitoring::Plugin::Config"
---

# Monitoring::Plugin::Config(3pm)

read nagios plugin .ini style config files

## NAME

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

## SYNOPSIS

```
    # Read given nagios plugin config file
    $Config = Monitoring::Plugin::Config->read( '/etc/nagios/plugins.ini' );
    # Search for and read default nagios plugin config file
    $Config = Monitoring::Plugin::Config->read();
    # Access sections and properties (returns scalars or arrayrefs)
    $rootproperty =  $Config->{_}->{rootproperty};
    $one = $Config->{section}->{one};
    $Foo = $Config->{section}->{Foo};
```

## DESCRIPTION

Monitoring::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

- •

  Monitoring::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, Monitoring::Plugin

## AUTHOR

This code is maintained by the Monitoring Plugin Development Team: see https://monitoring-plugins.org

## COPYRIGHT AND LICENSE

Copyright (C) 2014      by Monitoring Plugin Team Copyright (C) 2006-2014 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.