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
|
<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.
<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 <em>-f</em> command line switch documentation below).</li>
<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 000000 void values.</li>
</ul>
<p>The list of hosts including specific options is kept in a file (<em>hosts</em> in the <em>ping</em> module directory, by default) passed as an argument to the module, as follows:
<p><b>Module options:</b>
<ul>
<li>
<em>-f filename</em>
<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 <em>hosts</em> file example in ping module directory).
</li>
<li>
<em>-r host</em>
<br>The machine hosting the pinging daemon <em>nmicmpd</em>, localhost by default (also see INSTALL file in ping module directory on how to setup the pinging daemon).
</li>
</ul>
<p><strong>Hosts file format</strong>:
<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>
<li>polling period in seconds: time difference between each echo requests (as many as count, see below) group</li>
<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>
<li>count: number of ICMP echo requests to be sent</li>
<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 <em>(information drawn from ping manual)</em>)</li>
<li>delay in seconds between ICMP echo requests (used if count is greater than 1, use 0 if you want to generate bursts)</li>
</ul>
<p><b>Examples:</b>
<pre>$ moodss ping
$ moodss ping -f /home/jdoe/hosts.lst
$ moodss ping -r foo.bar.com
</pre>
</body>
</html>
|
