survivor: Pingx Check Module

SURVIVOR: `pingx` Check Module
About `pingx` Dependencies Arguments Description Examples
About `pingx`
basics |
Module Type | Scheduler | Remote
check | Yes | No
This module is not installed by default. Details below.
syntax |
         module pingx {
           [packets <number>]
           [throttle <number>]
           [maxwait <number>]
           [warnloss <number>]
           [probloss <number>]
           [warntime <number>]
           [probtime <number>]
         }
### Dependencies None ### Arguments
Name | Type | Value
packets | optional number greater than zero, default is 1 | Number of packets to send to target host.
throttle | optional number greater than zero, default is 1 | Number of packets to send before waiting for a reply.
maxwait | optional number greater than zero, default is 1 | Number of seconds to wait before assuming no reply.
warnloss | optional number between 1 and 101 | Percentage of packets lost to generate a warning.
probloss | optional number between 1 and 101, default is 1 | Percentage of packets lost to generate a problem.
warntime | optional number greater than zero | Generate a warning if the average round trip time is at least the specified number of milliseconds.
probtime | optional number greater than zero | Generate a problem if the average round trip time is at least the specified number of milliseconds.
1. ### Description The `pingx` module performs an ICMP echo reply query on the host to be checked. Because it must be installed setuid root to generate these queries, the module is not installed by default. To install the module, type `make install-manual` in the `pingx` directory of the SURVIVOR build. The ping module is installed by default. Setting the `throttle` argument higher will increase the parallelization of the module, allowing more pings to be sent in a shorter amount of time. However, doing so may decrease the reliability of the round trip time measurements. Setting the `maxwait` argument higher will allow slower responding hosts to not be marked down, however it may increase the likelihood of the module timing out. ### Examples To ping hosts:
            module pingx {}
2. To send 3 packets to each host, warning if the average response time for the 3 packets is at least 10 milliseconds:
            module pingx {
              packets 3
              warntime 10
            }
3. To send 3 packets to each host, throttling after 50 are sent until replies are received:
            module pingx {
              packets 3
              throttle 50
            }
$Date: 2006/11/19 21:15:35 $ $Revision: 0.3 $ | keywords maxwait packets probloss probtime throttle warnloss warntime