From: Stephen L Johnson <sjohnson@monsters.org>
Date: Tue, 19 Dec 2000 20:03:34 +0000 (+0000)
Subject: updated 'services' section for new host check bailout feature if a flagged test fails
X-Git-Tag: spong-2_7_2~32
X-Git-Url: http://git.etc.gen.nz/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b9aa656a7c8314539d87c4bf9e725245feea2caf;p=spong.git

updated 'services' section for new host check bailout feature if a flagged test fails
---

diff --git a/pod/spong.hosts.pod b/pod/spong.hosts.pod
index 245ced5..0148a97 100755
--- a/pod/spong.hosts.pod
+++ b/pod/spong.hosts.pod
@@ -38,16 +38,26 @@ machine might have.
 
 =back
 
-The services is a string listing the network modules to run against the host
-separated by spaces.  The list of network modules included with Spong is
-constantly growing, but they include ``dns'' , ``ftp'', ``smtp'', ``http'',
-``imap'', ``pop3'', ``nntp'', ``nfs'',``ntp'' and ``ssh''.  The list can
-include any addition network checks that you have developed (see
-L<spong-network> and L<developer-guide> for more details) . Any host listed
-is automatically checked for network connectivity (via ping). The meta-service
+The I<services> attribute  is a string listing the network modules to run
+against the host separated by spaces.  The list of network modules included
+with Spong is constantly growing, but they include ``dns'' , ``ftp'', ``smtp'',
+``http'', ``imap'', ``pop3'', ``nntp'', ``nfs'',``ntp'' and ``ssh''.  The list
+can include any addition network checks that you have developed (see
+L<spong-network> and L<developer-guide> for more details) . Any host listed is
+automatically checked for network connectivity (via ping). The meta-service
 ``noping'' can be included in the list of modules to cause B<spong-network> to
 skip the ``ping'' test.
 
+Service names in I<services> can be flagged to skip the remaining checks if it
+fails. The tests that are slipped are flagged with a special "clear" status 
+color. The "clear" status mean they have not been checked due special
+circumstances. The service name is flagged by appending a colon (":") on the end
+of the service name. For example:
+
+  'myhost.org' => {  'services' => 'ping: ftp smtp' },
+
+Skip the 'ftp' and 'smtp' checks if the 'ping' check fails.
+
 The I<down> attribute is a list of ``downtimes''. It is a list (well reference
 to one anyway) of one or more strings in the following format -
 ``d:hh:mm-hh:mm''.  ``d'' is the day of the week (0-6, 0 = Sunday, 6 =