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.sgml24
1 files changed, 19 insertions, 5 deletions
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml
index 3c37e5c..ad6f59e 100644
--- a/doc/developer-guidelines.sgml
+++ b/doc/developer-guidelines.sgml
@@ -209,7 +209,7 @@
209 209
210 <para>Notes:</para> 210 <para>Notes:</para>
211 <orderedlist> 211 <orderedlist>
212 <listitem><para>start &gt; end</para> 212 <listitem><para>start &le; end</para>
213 </listitem> 213 </listitem>
214 <listitem><para>start and ":" is not required if start=0</para> 214 <listitem><para>start and ":" is not required if start=0</para>
215 </listitem> 215 </listitem>
@@ -598,7 +598,7 @@ need to be fixed. As long as the return code is 0, it will be reported as "test
598</para> 598</para>
599 599
600<para> 600<para>
601If you want a summary test, run: "cd plugins && perl -MTest::Harness -e 'runtests(@ARGV)' t/check_disk.t". 601If you want a summary test, run: "cd plugins && prove t/check_disk.t".
602This runs the test in a summary format. 602This runs the test in a summary format.
603</para> 603</para>
604 604
@@ -612,9 +612,23 @@ link</ulink>
612 612
613<section><title>Testing the C library functions</title> 613<section><title>Testing the C library functions</title>
614<para> 614<para>
615Will be looking at using libtap, which is utilised by the FreeBSD team. The output is 615Uses <ulink url="http://jc.ngo.org.uk/trac-bin/trac.cgi/wiki/LibTap">the libtap library</ulink>, which gives
616based on perl's TAP (Test Anything Protocol) format, so that Test::Harness will understand 616perl's TAP
617results. This is still in planning stages. 617(Test Anything Protocol) output. This is used by the FreeBSD team for their regression testing.
618</para>
619
620<para>
621To run tests using the libtap library, download from http://people.freebsd.org/~nik/public_distfiles/
622and compile. There is a problem with tap-1.01
623where <ulink url="http://jc.ngo.org.uk/trac-bin/trac.cgi/ticket/25">pthread support doesn't appear to work</ulink>
624properly on non-FreeBSD systems. Compile with 'CPPFLAGS="-UHAVE_LIBPTHREAD" ./configure'. You do not need
625to install.
626</para>
627
628<para>
629You then have to run the Nagios Plugins' configure with the --with-libtap-object=full_path to the compiled
630tap.o file.
631Then run "make" and "make test" to run all tests.
618</para> 632</para>
619</section> 633</section>
620 634