summaryrefslogtreecommitdiffstats
path: root/doc/developer-guidelines.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/developer-guidelines.sgml')
-rw-r--r--doc/developer-guidelines.sgml59
1 files changed, 27 insertions, 32 deletions
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index 61b9f17..d934028 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -1,18 +1,18 @@
1<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > 1<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" >
2<book> 2<book>
3 <title>Nagios Plugin Development Guidelines</title> 3 <title>Monitoring Plugins Development Guidelines</title>
4 4
5 <bookinfo> 5 <bookinfo>
6 <authorgroup> 6 <authorgroup>
7 <author> 7 <author>
8 <affiliation> 8 <affiliation>
9 <orgname>Nagios Plugins Development Team</orgname> 9 <orgname>Monitoring Plugins Development Team</orgname>
10 </affiliation> 10 </affiliation>
11 </author> 11 </author>
12 </authorgroup> 12 </authorgroup>
13 13
14 <pubdate>2013</pubdate> 14 <pubdate>2013</pubdate>
15 <title>Nagios Plugin Development Guidelines</title> 15 <title>Monitoring Plugins Development Guidelines</title>
16 16
17 <revhistory> 17 <revhistory>
18 <revision> 18 <revision>
@@ -23,7 +23,7 @@
23 23
24 <copyright> 24 <copyright>
25 <year>2000 - 2013</year> 25 <year>2000 - 2013</year>
26 <holder>Nagios Plugins Development Team</holder> 26 <holder>Monitoring Plugins Development Team</holder>
27 </copyright> 27 </copyright>
28 28
29</bookinfo> 29</bookinfo>
@@ -34,8 +34,8 @@
34 the plugin developers and encourage the standarization of the 34 the plugin developers and encourage the standarization of the
35 different kind of plugins: C, shell, perl, python, etc.</para> 35 different kind of plugins: C, shell, perl, python, etc.</para>
36 36
37 <para>Nagios Plugin Development Guidelines Copyright (C) 2000-2013 37 <para>Monitoring Plugins Development Guidelines Copyright (C) 2000-2013
38 (Nagios Plugins Team)</para> 38 (Monitoring Plugins Team)</para>
39 39
40 <para>Permission is granted to make and distribute verbatim 40 <para>Permission is granted to make and distribute verbatim
41 copies of this manual provided the copyright notice and this 41 copies of this manual provided the copyright notice and this
@@ -48,8 +48,8 @@
48<article> 48<article>
49<section id="DevRequirements"><title>Development platform requirements</title> 49<section id="DevRequirements"><title>Development platform requirements</title>
50 <para> 50 <para>
51 Nagios Plugins are developed to the GNU standard, so any OS which is supported by GNU 51 Monitoring Plugins are developed to the GNU standard, so any OS which is supported by GNU
52 should run the plugins. While the requirements for compiling the Nagios Plugins release 52 should run the plugins. While the requirements for compiling the Monitoring Plugins release
53 are very basic, developing from the Git repository requires additional software to be 53 are very basic, developing from the Git repository requires additional software to be
54 installed. These are the minimum levels of software required: 54 installed. These are the minimum levels of software required:
55 55
@@ -152,7 +152,7 @@
152 <section><title>Plugin Return Codes</title> 152 <section><title>Plugin Return Codes</title>
153 <para>The return codes below are based on the POSIX spec of returning 153 <para>The return codes below are based on the POSIX spec of returning
154 a positive value. Netsaint prior to v0.0.7 supported non-POSIX 154 a positive value. Netsaint prior to v0.0.7 supported non-POSIX
155 compliant return code of "-1" for unknown. Nagios supports POSIX return 155 compliant return code of "-1" for unknown. Nagios supports POSIX return
156 codes by default.</para> 156 codes by default.</para>
157 157
158 <para>Note: Some plugins will on occasion print on STDOUT that an error 158 <para>Note: Some plugins will on occasion print on STDOUT that an error
@@ -379,7 +379,7 @@
379 </listitem> 379 </listitem>
380 </orderedlist> 380 </orderedlist>
381 381
382 <para>It is up to third party programs to convert the Nagios Plugins 382 <para>It is up to third party programs to convert the Monitoring Plugins
383 performance data into graphs.</para> 383 performance data into graphs.</para>
384 </section> 384 </section>
385 385
@@ -678,11 +678,6 @@ To run a test, from the top level directory, run "make test". This will run
678all the current tests and report an overall success rate. 678all the current tests and report an overall success rate.
679</para> 679</para>
680 680
681<para>
682See the <ulink url="http://tinderbox.opsera.com">Nagios Plugins Tinderbox server</ulink>
683for the daily test results.
684</para>
685
686<section><title>Test cases for plugins</title> 681<section><title>Test cases for plugins</title>
687<para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t". 682<para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t".
688</para> 683</para>
@@ -699,7 +694,7 @@ This runs the test in a summary format.
699 694
700<para> 695<para>
701For a good and amusing tutorial on using Test::More, see this 696For a good and amusing tutorial on using Test::More, see this
702<ulink url="http://search.cpan.org/~mschwern/Test-Simple-0.62/lib/Test/Tutorial.pod"> 697<ulink url="http://search.cpan.org/dist/Test-Simple/lib/Test/Tutorial.pod">
703link</ulink> 698link</ulink>
704</para> 699</para>
705 700
@@ -720,7 +715,7 @@ properly on non-FreeBSD systems. Install with 'CPPFLAGS="-UHAVE_LIBPTHREAD" ./co
720</para> 715</para>
721 716
722<para> 717<para>
723When you run Nagios Plugins' configure, it will look for the tap library and will automatically 718When you run Monitoring Plugins' configure, it will look for the tap library and will automatically
724setup the tests. Run "make test" to run all the tests. 719setup the tests. Run "make test" to run all the tests.
725</para> 720</para>
726</section> 721</section>
@@ -752,9 +747,9 @@ setup the tests. Run "make test" to run all the tests.
752 </section> 747 </section>
753 748
754 <section><title>Commit Messages</title> 749 <section><title>Commit Messages</title>
755 <para>If the change is due to a contribution, please quote the contributor's name 750 <para>If the change is due to a contribution, please quote the contributor's name
756 and, if applicable, add the SourceForge Tracker number. Don't forget to 751 and, if applicable, add the GitHub Issue Tracker number. Don't forget to
757update the THANKS.in file.</para> 752 update the THANKS.in file.</para>
758 <para>If you have a change that is useful for noting in the next release, please 753 <para>If you have a change that is useful for noting in the next release, please
759 update the NEWS file.</para> 754 update the NEWS file.</para>
760 <para>All commits will be written to a ChangeLog at release time. 755 <para>All commits will be written to a ChangeLog at release time.
@@ -765,7 +760,7 @@ update the THANKS.in file.</para>
765 <para>To make the job easier for translators, please follow these guidelines:</para> 760 <para>To make the job easier for translators, please follow these guidelines:</para>
766 <orderedlist> 761 <orderedlist>
767 <listitem><para> 762 <listitem><para>
768 Before creating new strings, check the po/nagios-plugins.pot file to 763 Before creating new strings, check the po/monitoring-plugins.pot file to
769 see if a similar string 764 see if a similar string
770 already exists 765 already exists
771 </para></listitem> 766 </para></listitem>
@@ -795,15 +790,15 @@ update the THANKS.in file.</para>
795 version you are using. For new features, please supply a diff against 790 version you are using. For new features, please supply a diff against
796 the Git "master" branch.</para> 791 the Git "master" branch.</para>
797 792
798 <para>Patches should be submitted via 793 <para>Patches should be submitted via
799 <ulink url="http://sourceforge.net/tracker/?group_id=29880&amp;atid=397599">SourceForge's 794 <ulink url="https://github.com/monitoring-plugins/monitoring-plugins/pulls">GitHub's
800 tracker system for Nagiosplug patches</ulink> 795 Pull requests for Monitoring Plugins</ulink>
801 and be announced to the nagiosplug-devel mailing list.</para> 796 </para>
802 797
803 <para>Submission of a patch implies that the submmitter acknowledges that they 798 <para>Submission of a patch implies that the submmitter acknowledges that they
804 are the author of the code (or have permission from the author to release the code) 799 are the author of the code (or have permission from the author to release the code)
805 and agree that the code can be released under the GPL. The copyright for the changes will 800 and agree that the code can be released under the GPL. The copyright for the changes will
806 then revert to the Nagios Plugin Development Team - this is required so that any copyright 801 then revert to the Monitoring Plugins Development Team - this is required so that any copyright
807 infringements can be investigated quickly without contacting a huge list of copyright holders. 802 infringements can be investigated quickly without contacting a huge list of copyright holders.
808 Credit will always be given for any patches through a THANKS file in the distribution.</para> 803 Credit will always be given for any patches through a THANKS file in the distribution.</para>
809 </section> 804 </section>
@@ -811,22 +806,22 @@ update the THANKS.in file.</para>
811 806
812 <section id="Contributedplugins"><title>Contributed plugins</title> 807 <section id="Contributedplugins"><title>Contributed plugins</title>
813 <para>Plugins that have been contributed to the project and 808 <para>Plugins that have been contributed to the project and
814 distributed with the Nagios Plugin files are held in the contrib/ directory and are not installed 809 distributed with the Monitoring Plugins files are held in the contrib/ directory and are not installed
815 by default. These plugins are not officially supported by the team. 810 by default. These plugins are not officially supported by the team.
816 The current policy is that these plugins should be owned and maintained by the original 811 The current policy is that these plugins should be owned and maintained by the original
817 contributor, preferably hosted on <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. 812 contributor, preferably hosted on <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>.
818 </para> 813 </para>
819 <para>If patches or bugs are raised to an contributed plugin, we will start communications with the 814 <para>If patches or bugs are raised to an contributed plugin, we will start communications with the
820 original contributor, but seek to remove the plugin from our distribution. 815 original contributor, but seek to remove the plugin from our distribution.
821 </para> 816 </para>
822 <para>The aim is to distribute only code that the Nagios Plugin team are responsible for. 817 <para>The aim is to distribute only code that the Monitoring Plugins team are responsible for.
823 </para> 818 </para>
824 </section> 819 </section>
825 820
826 <section id="Newplugins"><title>New plugins</title> 821 <section id="Newplugins"><title>New plugins</title>
827 <para>If you would like others to use your plugins, please add it to 822 <para>If you would like others to use your plugins, please add it to
828 the official 3rd party plugin repository, 823 the official 3rd party plugin repository,
829 <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. 824 <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>.
830 </para> 825 </para>
831 826
832 <para>We are not accepting requests for inclusion of plugins into 827 <para>We are not accepting requests for inclusion of plugins into
@@ -837,7 +832,7 @@ update the THANKS.in file.</para>
837 <orderedlist> 832 <orderedlist>
838 <listitem> 833 <listitem>
839 <para>Include copyright and license information in all files. Copyright must be solely 834 <para>Include copyright and license information in all files. Copyright must be solely
840 granted to the Nagios Plugin Development Team</para> 835 granted to the Monitoring Plugins Development Team</para>
841 </listitem> 836 </listitem>
842 <listitem> 837 <listitem>
843 <para>The standard command options are supported (--help, --version, 838 <para>The standard command options are supported (--help, --version,