From 6d76521656e91daa160bc8019828f1b68d7aa5dc Mon Sep 17 00:00:00 2001 From: Niko Tyni Date: Sun, 13 Feb 2005 19:23:04 +0000 Subject: Moved probes, matchers and ciscoRttMonMIB modules to lib/Smokeping. --- doc/smokeping_extend.pod | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'doc') diff --git a/doc/smokeping_extend.pod b/doc/smokeping_extend.pod index 536ac77..4d3f24d 100644 --- a/doc/smokeping_extend.pod +++ b/doc/smokeping_extend.pod @@ -17,17 +17,17 @@ source of this document are most appreciated. The first thing you should decide is which base class you should use for your probe. For most (if not all) uses it's a choice between -C and C. The former is intended for probes +C and C. The former is intended for probes that can measure their targets all in one go, while the latter is for probing them one at a time, possibly in several concurrent subprocesses. -At the moment, the only probes that use C are the FPing -derivatives. All the others use C, and chances are +At the moment, the only probes that use C are the FPing +derivatives. All the others use C, and chances are you should too. This document will thus concentrate on the latter case. =head1 SKELETON FILE -The C module is a non-functional probe that is intended +The C module is a non-functional probe that is intended to make a good basis for a new probe module. Copy the file, C, to a new name and just fill out the blanks :) Note that real probe modules must have at least one capital letter @@ -63,7 +63,7 @@ C method for probe-specific variables and a C method for target-specific variables. If you don't know the difference between these yet, see the L document. -(The probes that are derived from C don't support +(The probes that are derived from C don't support target-specific variables, so they only use the C method.) The base classes offer these methods too to provide the variables that @@ -88,7 +88,7 @@ convenience method called C<_makevars> that does this, and the common idiom is The variables are declared in a syntax that comes from the module used for parsing the configuration file, C. Each variable should be a hash that uses the "special variable keys" documented in -the C manual. See the C and the other +the C manual. See the C and the other probes for examples. For reference, here are the keys the hash should have. Much of this @@ -154,13 +154,13 @@ If you must do something at probe initialization time, like check that the external program you're going to use behaves as you expect, you should do it in the C method. You should probably also take care that you don't run the tests needlessly while in CGI mode. The usual way to -do this is to test for $ENV{SERVER_SOFTWARE}. See the C +do this is to test for $ENV{SERVER_SOFTWARE}. See the C module for an example. =head1 PINGING All the real action happens in the C method (or, for -C-derived probes, in the C method.) The arguments +C-derived probes, in the C method.) The arguments for C are C<$self>, the module instance (since this is a method) and C<$target>, the target to be probed. @@ -191,7 +191,7 @@ speak up if you think you'd use it. If you deal with timeouts (for example because your program offers a parameter for specifying the timeout for the pings), you should know a few things. -First, there's timeout logic in C that kills the probe +First, there's timeout logic in C that kills the probe when the timeout is reached. By default the timeout is (# of pings * 5 seconds) + 1 second. If you expect that your pings can take longer, you should modify the default value of the probe-specific variable C. @@ -208,14 +208,14 @@ This would be done like this: If you want to provide a target-specific C setting, you should delete the probe-specific variable and be sure to provide a default for -your target-specific one. See eg. C for an example of +your target-specific one. See eg. C for an example of how this is done. Providing a target-specific C will make the timeout in -C be (# of pings * the maximum timeout of all targets) +C be (# of pings * the maximum timeout of all targets) + 1 second. The 1 second is added so that the own timeout logic of the probe has time to kick in even in the worst case (ie. all pings are lost) -before C starts killing the processes. +before C starts killing the processes. =head1 COPYRIGHT -- cgit v1.2.3-24-g4f1b