66 lines
2.7 KiB
Plaintext
66 lines
2.7 KiB
Plaintext
monitoring-plugins-cyconet - Plugins for nagios compatible monitoring systems
|
|
--------------------------------------------------------------------------
|
|
|
|
This README.source should give a short instruction about the
|
|
way the monitoring-plugins-cyconet 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 dh_auto_* 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.
|
|
|