SURVIVOR: pingx Check Module
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.

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

  1. 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