X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Fdeveloper-guidelines.sgml;h=ed7e422692f7c821063be0e372c3ef42b8583db7;hb=12c17fe8a25ada493a87ed3d5a5885e3414052ac;hp=af70cef60dbbe4a63f58e4fc37b0c0dd62e963c5;hpb=5817bf6a784da2420c01583dbdfee7fc24003541;p=nagiosplug.git
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index af70cef..ed7e422 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -16,8 +16,8 @@
- $Revision$
- $Date$
+ 1796
+ 2007-09-24 14:51:07 -0400 (Mon, 24 Sep 2007)
@@ -55,8 +55,10 @@
gnu make 3.79
- automake 1.8.3
- autoconf 2.58
+ automake 1.9.2
+ autoconf 2.59
+ gnu m4 1.4.2
+ gnu libtool 1.5
To compile from CVS, after you have checked out the code, run:
@@ -85,11 +87,14 @@
the entire output to appear in a pager message, which will get chopped
off after a certain length.
+ As Nagios does not capture stderr output, you should only output to
+ STDOUT and not print to STDERR.
+
Print only one line of text
Nagios will only grab the first line of text from STDOUT
when it notifies contacts about potential problems. If you print
- multiple lines, you're out of luck. Remember, keep it short and
- to the point.
+ multiple lines, you're out of luck (though this will be a feature of
+ Nagios 3). Remember, keep your output short and to the point.
Output should be in the format:
@@ -137,8 +142,9 @@
Screen Output
The plug-in should print the diagnostic and just the
- synopsis part of the help message. A well written plugin would
+ usage part of the help message. A well written plugin would
then have --help as a way to get the verbose help.
+
Code and output should try to respect the 80x25 size of a
crt (remember when fixing stuff in the server room!)
@@ -241,6 +247,83 @@
Note: Not all plugins are coded to expect ranges in this format yet.
There will be some work in providing multiple metrics.
+
+ Example ranges
+
+
+
+ Range definition
+ Generate an alert if x...
+
+
+
+
+ 10
+ < 0 or > 10, (outside the range of {0 .. 10})
+
+
+ 10:
+ < 10, (outside {10 .. ∞})
+
+
+ ~:10
+ > 10, (outside the range of {-∞ .. 10})
+
+
+ 10:20
+ < 10 or > 20, (outside the range of {10 .. 20})
+
+
+ @10:20
+ ≥ 10 and ≤ 20, (inside the range of {10 .. 20})
+
+
+ 10
+ < 0 or > 10, (outside the range of {0 .. 10})
+
+
+
+
+ Command line examples
+
+
+
+ Command line
+ Meaning
+
+
+
+
+ check_stuff -w10 -c20
+ Critical if "stuff" is over 20, else warn if over 10 (will be critical if "stuff" is less than 0)
+
+
+ check_stuff -w~:10 -c~:20
+ Same as above. Negative "stuff" is OK
+
+
+ check_stuff -w10: -c20
+ Critical if "stuff" is over 20, else warn if "stuff" is below 10 (will be critical if "stuff" is less than 0)
+
+
+ check_stuff -c1:
+ Critical if "stuff" is less than 1
+
+
+ check_stuff -w~:0 -c10
+ Critical if "stuff" is above 10; Warn if "stuff" is above zero
+
+
+ check_stuff -c5:6
+ The only noncritical range is 5:6
+
+
+ check_stuff -c10:20
+ Critical if "stuff" is 10 to 20
+
+
+
+
Performance data
@@ -595,7 +678,7 @@ all the current tests and report an overall success rate.
-See the Nagios Plugins Tinderbox server
+See the Nagios Plugins Tinderbox server
for the daily test results.
@@ -652,6 +735,10 @@ setup the tests. Run "make test" to run all the tests.
You should use /* */ for comments and not // as some compilers
do not handle the latter form.
+
+ You should also avoid using the type "bool" and its values
+ "true" and "false". Instead use the "int" type and the plugins' own
+ "TRUE"/"FALSE" values to keep the code uniformly.
Crediting sources
@@ -664,23 +751,13 @@ setup the tests. Run "make test" to run all the tests.
CVS comments
- When adding CVS comments at commit time, you can use the following prefixes:
-
- - comment
-
- for a comment that can be removed from the Changelog
-
-
- * comment
-
- for an important amendment to be included into a features list
-
-
-
-
If the change is due to a contribution, please quote the contributor's name
and, if applicable, add the SourceForge Tracker number. Don't forget to
update the THANKS.in file.
+ If you have a change that is useful for noting in the next release, please
+ update the NEWS file.
+ All CVS commit comments will be written to a ChangeLog at release time.
+
Translations for developers
@@ -730,8 +807,22 @@ update the THANKS.in file.
Credit will always be given for any patches through a THANKS file in the distribution.
- New plugins
+ Contributed plugins
+ Plugins that have been contributed to the project and
+ distributed with the Nagios Plugin files are held in the contrib/ directory and are not installed
+ by default. These plugins are not officially supported by the team.
+ The current policy is that these plugins should be owned and maintained by the original
+ contributor, preferably hosted on NagiosExchange.
+
+ If patches or bugs are raised to an contributed plugin, we will start communications with the
+ original contributor, but seek to remove the plugin from our distribution.
+
+ The aim is to distribute only code that the Nagios Plugin team are responsible for.
+
+
+
+ New plugins
If you would like others to use your plugins, please add it to
the official 3rd party plugin repository,
NagiosExchange.
@@ -744,7 +835,8 @@ update the THANKS.in file.
- Include copyright and license information in all files
+ Include copyright and license information in all files. Copyright must be solely
+ granted to the Nagios Plugin Development Team
The standard command options are supported (--help, --version,