nagios-plugins/contrib

Contrib Plugins README
----------------------

This directory contains plugins which have been contributed by various people, but that
have not yet been incorporated into the core plugins distribution.

Most Perl plugins should work without modification. Some of the C plugins may require
a few tweaks to compile.

If you have questions regarding the use of these plugins, try contacting the author(s)
or post a message to the nagiosplug-help mailing list (nagiosplug-help@lists.sourceforge.net)
requesting assistance.



Contrib Tarballs
----------------

In addition to the plugins located in this directory, there are some additional tarballs
containing plugins in the tarballs/ subdirectory. They have not yet been organized.
A brief description of their contents follows.


berger-ping.tar.gz - Perl script version of the check_ping plugin and a corresponding
CGI (mtr.cgi) that uses mtr to traceroute a path to a host.
(Gary Berger)

bowen-langley_plugins.tar.gz
- Several C plugins including check_inode, check_boot, etc.
(Adam Bown & Thomas Langley)


check_bgp-1.0.tar.gz - Perl script intended for monitoring BGP sessions on Cisco routers.
Only useful if you are using BGP4 as a routing protocol. For
critical alert the AS (autonomous system) number has to be in the
uplinks hash (see the source code). Requires SNMP read community.
(Christoph Kron)

check_memory.tgz - C plugin to check available system memory

check_radius.tar.gz - C program to check RADIUS authentication. This is a hacked version of
the Cistron Radiusd program radtest that acts as a plugin for Nagios.
The vast majority of the code was written by someone at Livingston
Enterprises and Cistron. NOTE: Due to the copyright restrictions in
this code, it cannot be distributed under the GPL license, and thus
will not appear in the core plugin distribution!
(Adam Jacob)

hopcroft-plugins.tar.gz - Various example plugin scripts contributed by Stanley Hopcroft.
Includes a plugin to check Internet connectivity by checking various
popular search engines, a plugin to check the availability of login
to a TN/3270 mainframe database using Expect to search for "usual"
screens, and another plugin to test the availability of a database
search via the web.
(Stanley Hopcroft)

radius.tar.gz - Code modifications necessary to make the radexample app
supplied with the radiusclient code work as a RADIUS plugin
for Nagios (Nick Shore)