monitoring-plugins  2.3.1
About: Monitoring Plugins for the Nagios host/service/network monitoring program (and other monitoring applications like Icinga, Naemon, Shinken, Sensu).
  Fossies Dox: monitoring-plugins-2.3.1.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

monitoring-plugins Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies monitoring-plugins-2.3.1.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README
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 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 the latest plugins at:

* <https://www.monitoring-plugins.org/>

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:

* <https://github.com/monitoring-plugins>


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.