Monitoring Plugins standards
Find a file
Jan Wagner df53473d03 check_dig: patch to make dig honor -t option
When a timeout value is specified with the -t option, dig will sometimes
timeout before the timer is actually reached.

The problem occurs because the check_dig plugin does not pass the specified
timeout value to dig, leaving dig to timeout with it's default value which
seems to be around 10-15seconds.

To reproduce:
time ./check_dig -H 127.0.0.2 -l www.google.com -t 30

It will not run for 30secs, which is the expected behaviour.

The following will work, because the timeout is less than the default dig
timeout, so the plugin cancels the dig command:
time ./check_dig -H 127.0.0.2 -l www.google.com -t 2

This fix passes the timeout value to dig, and sets the number of retries which tends to vary from system to system by default.

Closes #1168
2014-01-30 11:07:22 +01:00
build-aux Update bundled libtool files 2013-09-05 00:03:00 +02:00
config_test Ficing C++ style comments 2007-03-08 06:12:36 +00:00
doc Project rename initial commit. 2014-01-19 14:18:47 -05:00
gl Add strcase gnulib module 2014-01-29 03:04:05 -05:00
lib Add tests for mp_translate_state() 2014-01-29 22:03:04 -05:00
m4 Project rename initial commit. 2014-01-19 14:18:47 -05:00
perlmods updated perldod with a renamed pkg 2014-01-20 14:55:18 +01:00
pkg Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
plugins check_dig: patch to make dig honor -t option 2014-01-30 11:07:22 +01:00
plugins-root Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
plugins-scripts check_mailq: adding nullmailer support 2014-01-29 13:45:36 +01:00
po Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
tap Clean up last commit - remove the __STDC_VERSION__ check in tap.h 2009-01-15 01:03:00 -05:00
tools Capitalize "Monitoring Plugins" 2014-01-21 16:19:20 +01:00
.gitignore AUpdate .gitignore for new gnulib module 2014-01-29 03:48:24 -05:00
ABOUT-NLS Updating gettext files from coreutils-6.9. mkinstalldirs needs to be in 2007-05-12 00:49:26 +00:00
acinclude.m4 Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
ACKNOWLEDGEMENTS Project rename initial commit. 2014-01-19 14:18:47 -05:00
AUTHORS Project rename initial commit. 2014-01-19 14:18:47 -05:00
autogen.sh Removing CVS/SVN tags and replacing with git-based versioning 2008-11-23 05:38:47 +00:00
CODING Project rename initial commit. 2014-01-19 14:18:47 -05:00
config.rpath make dist failing without config.rpath in top level. File copied 2007-01-30 09:56:47 +00:00
configure.in Enable extra-opts by default 2014-01-23 03:42:26 -05:00
COPYING Update the COPYING file to the GPLv3 2010-07-27 23:06:23 +02:00
FAQ Project rename initial commit. 2014-01-19 14:18:47 -05:00
LEGAL Initial revision 2002-02-28 06:42:51 +00:00
Makefile.am Project rename initial commit. 2014-01-19 14:18:47 -05:00
mkinstalldirs Adding more required files from gettext 2006-05-19 21:30:59 +00:00
monitoring-plugins.spec.in Merge branch 'maint' 2014-01-21 16:07:38 +01:00
NEWS check_swap: add supports for a configurable state when there is no swap 2014-01-29 03:40:11 -05:00
NP-VERSION-GEN Prepare for the 1.5 release 2013-10-02 17:21:01 +02:00
NPTest.pm Fix tests with an empty NPTest.cache file 2014-01-26 04:49:32 -05:00
opttest.pl Initial revision 2002-02-28 06:42:51 +00:00
README README: Minor fixes regarding new project name 2014-01-21 21:56:23 +01:00
README.md Add symlink: README.md -> README 2013-09-20 17:00:40 +02:00
REQUIREMENTS Project rename initial commit. 2014-01-19 14:18:47 -05:00
ROADMAP some minor fixes 2004-12-03 17:48:53 +00:00
SUPPORT Project rename initial commit. 2014-01-19 14:18:47 -05:00
test.pl.in no need to set verbose mode, thats what "make test-debug" is for 2013-08-21 17:23:22 +02:00
THANKS.in check_dig: patch to make dig honor -t option 2014-01-30 11:07:22 +01:00

Monitoring Plugins

  • For instructions on installing these plugins for use with your monitoring system, 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@monitoring-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@monitoring-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.monitoring-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 your monitoring system is installed (default is /usr/local), and replace SOMEURL with the path used to access the monitoring system 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@monitoring-plugins.org.

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.