Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Nagios Plugins
C Shell Perl C++
Failed to load latest commit information.
build-aux Update bundled libtool files
config_test Ficing C++ style comments
doc doc/developer-guidelines.sgml - Copyright change
gl whitespace cleanup
lib whitespace cleanup
m4 m4/np_mysqlclient.m4 - Copyright changes
perlmods Merge branch 'hw/update-pm'
pkg Update URLs and mailing list addresses
plugins-root plugins-root/check_dhcp.c - array out of bounds
plugins-scripts Revert "check_mailq: try to autodetect which mailq implementation we …
plugins Merge branch 'master' into maint
po po/fr.po - Copyright changes
tap Clean up last commit - remove the __STDC_VERSION__ check in tap.h
tools tools/git-notify - Copyright changes
.gitignore added check_uptime bin to gitignore
ABOUT-NLS Updating gettext files from coreutils-6.9. mkinstalldirs needs to be in
ACKNOWLEDGEMENTS Added thanks to Ethan in the ACKNOWLEDGEMENTS doc
AUTHORS Added myself and spenser to AUTHORS doc
CODING Moved suggested plugin options from ROADMAP to CODING
COPYING Update the COPYING file to the GPLv3
FAQ updated FAQ to include new methods of contact
LEGAL Added Nagios-Plugins to the trademark notice
Makefile.am Add tools/generate-change-log
NEWS Updated NEWS for 2.0.3
NP-VERSION-GEN Prep for 2.0.3
NPTest.pm Enable tests in tests/ subdirs
README Updated README to include testing instructions
README.md Add symlink: README.md -> README
REQUIREMENTS Added a note about check_uptime only supporting liunux atm
ROADMAP some minor fixes
SUPPORT Added FORUMS section to SUPPORT doc
THANKS.in Updated THANKS.in
acinclude.m4 Removing CVS/SVN tags and replacing with git-based versioning
autogen.sh Removing CVS/SVN tags and replacing with git-based versioning
config.rpath make dist failing without config.rpath in top level. File copied
configure.ac Prep for 2.0.3
mkinstalldirs Adding more required files from gettext
nagios-plugins.spec.in Fix #1217 spec file fails to build due to duplicate files and unused …
opttest.pl Initial revision
test.pl.in Enable tests in tests/ subdirs

README.md

Nagios Plugins

  • For instructions on installing these plugins for use with Nagios, see below. In addition, generic instructions for the GNU toolchain can be found in the INSTALL file.

  • For major changes between releases, read the NEWS file.

  • For information on detailed changes that have been made or plugins that have been added, read the ChangeLog file.

  • Some plugins require that you have additional programs and/or libraries installed on your system before they can be used. Plugins that are dependent on other programs/libraries that are missing are usually not compiled. Read the REQUIREMENTS file for more information.

  • Individual plugins are self-documenting. All plugins that comply with the basic guidelines for development will provide detailed help when invoked with the -h or --help options.

You can check for the latest plugins at:

Send an email to help@nagios-plugins.org for assistance. Please include the OS type and version that you are using. Also, run the plugin with the -vvv option and provide the resulting version information. Of course, there may be additional diagnostic information required as well. Use good judgment.

Send an email to devel@nagios-plugins.org for developer discussions.

For patch submissions and bug reports, please use the appropriate resources at:

Installation Instructions

  1. If you are using the Git tree, you will need m4, gettext, automake, and autoconf. To start out, run:

    ./tools/setup
    

    For more detail, see the developer guidelines at https://www.nagios-plugins.org/doc/guidelines.html.

  2. Run the configure script to initialize variables and create a Makefile, etc.

    ./configure --prefix=BASEDIRECTORY --with-cgiurl=SOMEURL
    

    Replace BASEDIRECTORY with the path of the directory under which Nagios is installed (default is /usr/local/nagios), and replace SOMEURL with the path used to access the Nagios CGIs with a web browser (default is /nagios/cgi-bin).

  3. Compile the plugins with the following command:

    make
    
  4. Install the compiled plugins and plugin scripts with the following command:

    make install
    

    The installation procedure will attempt to place the plugins in a libexec/ subdirectory in the base directory you specified with the --prefix argument to the configure script.

  5. There are some plugins that require setuid. If you run make install as a non-root user, they will not be installed. To install, switch to root and run:

    make install-root
    

That's it! If you have any problems or questions, feel free to send an email to help@nagios-plugins.org.

Testing With libtap

  1. The nagios-plugins source includes a perl testing suite. the libtap library and headers are included with the source. Configure with:

    ./configure --enable-libtap

    Note: "--enable-extra-opts" used to be required as well, but is no longer required as it is a default configure option.

  2. Make and then make test:

    make make test

  3. Testing is pseudo intelligent and will try to autodetect which plugins to test. You may need to look at the REQUIREMENTS doc as to what dependencies are required to satisfy the test.

    Additionally, default and user supplied (at runtime) testing parameters are saved in the file:

    /var/tmp/NPTest.cache

    If you need to change any testing parameters, edit them in this file or just remove the line to force the test to re-prompt you for input.

License Notice

You can redistribute and/or modify this software under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version; with the additional exemption that compiling, linking, and/or using OpenSSL is allowed.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the COPYING file for the complete text of the GNU General Public License, version 3.

Something went wrong with that request. Please try again.