1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
<html>
<head>
<title>ping moodss module</title>
</head>
<body>
<p>This module allows the monitoring of several hosts by pinging them, that is sending one or more ICMP echo requests and reporting the round trip time for each host.
<p><i><b>Notes</b>:<ul>
<li>this module internally uses 64 bit row numbers and therefore requires Tcl/Tk 8.4 or above (which is already the case if you are reading this from a running moodss application).
<li>on Windows, it requires the Tnm Tcl extension package (from the Scotty Tcl extension software) to be installed on the computer (use the latest release from <a href="http://spog.gaertner.de/~schoenfr/scotty/">http://spog.gaertner.de/~schoenfr/scotty/</a>).
</ul></i>
<pre><img src="ping.gif" alt="view of module tables"></pre>
<p>Data is displayed in 2 tables:
<ul>
<li>The first containing static data as specified in the hosts options file (see <i>-f</i> command line switch documentation below), except for the <i>replied</i> column (address used in the ICMP echo reply) placed next to the <i>address</i> column to make differences visually obvious.
<li>The second containing dynamic data resulting from the ICMP traffic from the pinged hosts. Invalid data, for unreachable hosts, is displayed using the special <i>?</i> void values.
</ul>
<p>The list of hosts including specific options is kept in a file (<i>hosts</i> in the <i>ping</i> module directory, by default) passed as an argument to the module, as follows:
<p><b>Error handling:</b>
<p>When an error occurs communicating with the <i>nmicmpd</i> daemon, a descriptive error message is generated. Displayed data is no longer updated until the daemon becomes reachable again.
<p><b>Module options:</b>
<ul>
<li><i>-f filename</i>
<br>Use specified file for hosts list with options. Each line in the file must contain the following items, separated by blanks (tabs or spaces): host name or IP address, polling period, timeout, count, size and delay (see <i>hosts</i> file example in ping module directory, but do not use it for real work, as it may be overwritten when upgrading moodss for example).
<li><i>-r host</i>
<br>The machine hosting the pinging daemon <i>nmicmpd</i>, localhost by default (also see INSTALL file in ping module directory on how to setup the pinging daemon).
</ul>
<p><b>Hosts file format</b>:
<p>While comment lines begin with the # character, other lines in the file must either be blank or contain the following items, separated by blanks (tabs or spaces):
<ul>
<li>host name or IP address
<li>polling period in seconds: time difference between each echo requests (as many as count, see below) group
<li>timeout in seconds: after which a new ICMP echo request is sent if there was no response for the previous request (if multiple packets are to be sent, see count below)
<li>count: number of ICMP echo requests to be sent
<li>size: ICMP packet size in bytes, must be greater than or equal to 56 (which translates into 64 ICMP data bytes when combined with the 8 bytes of ICMP header data <i>(information drawn from ping manual)</i>)
<li>delay in seconds between ICMP echo requests (used if count is greater than 1, use 0 if you want to generate bursts)
</ul>
<p><b>Examples:</b>
<pre>$ moodss ping
$ moodss ping -f /home/jdoe/hosts.lst
$ moodss ping -r foo.bar.com
</pre>
</body>
</html>
|
