nagios-plugins-contrib - Plugins for nagios compatible monitoring systems

This README.source should give a short instruction about the way the pkg-nagios-plugins-contrib repository is structured and defines basic policies.

• build-system: git-buildpackage. As we build a Debian native package pristine-tar is not necessary.

• debian/changelog:

  • preferable generated using git-dch
  • versioning schema: X.$(date '+%Y%m%d'). X will be increased by one with each release. In case there are bugfixes in stable releases necessary, use X.$(date '+%Y%m%d').Y See http://kitenet.net/~joey/blog/entry/version_numbers/ for details.

• debian/copyright.in, debian/control.in: Base files we fill automatically with information from all plugins to generate the full files. This is done in the clean target. DO NOT MODIFY debian/control or debian/copyright!

• nagios plugins:

  • one directory per plugin
  • required files:
  • $plugin/control: file format similar to debian/control.
    • Required is the Description and Uploaders part. Add Build-Depends, Recommends, Suggests and Homepage to have their content added to debian/control/ debian/copyright. Don't use Depends as we don't want to force people to install dependencies for a plugin they might not want to use.
    • Add Version to be able to track an upstream version of the plugin.
    • Add Watch to check for new versions using ./debian/packaging-helper.py Format: Watch URL python-regex Watch URL SHA1:sha1sum
    • Don't add empty lines - only the first paragraph will be handled.
  • $plugin/copyright: copyright information for the files in $plugin. Will be added to debian/copyright automatically, properly indented and with a header which describes that the coming block is for the files in $plugin. DEP-5 IS NOT SUPPORTED
  • what you should have: Currently there are two options on how to build and install plugins:
  • you have a single script or file or need some hand-made build system anyway: add $plugin/Makefile and implement the all / install / clean targets. include ../common.mk is there for common tasks. If $plugin/Makefile exists the way described below will not be built.
  • your plugin comes with a fancy build system already: extract the source in $plugin and let a symlink called 'src' point to the subdirectory of $plugin. If dhauto* is not able to build the plugin, please use the Makefile way as described above. Please ensure that a proper .cfg file will be installed.