NetPinger Configuration File

NetPinger uses hosts.cfg file to stores list of hosts for pinging and ping options in XML format.

Version 1.0

NetPinger version 1.0 configuration file has following format:

<pinger>

    <!-- List of host -->

    <host>

        <!-- Host options -->

	<name><!-- host name --></name>
	<ip><!-- host ip --></ip>
	<timeout><!-- timeout --></timeout>
	<interval><!-- ping interval --></interval>
	<pingsbeforedead><!-- pings before dead --></pingsbeforedead>
	<buffersize><!-- echo message size --></buffersize>
	<ttl><!-- Time To Live --></ttl>
	<dontfragment><!-- Don't fragmen flag --></dontfragment>

    </host>

    <host>

        <!-- Host options -->
        <!-- ... -->

    </host>

    <!-- More host... -->

</pinger>

Defined options:

Name	Type	Required	Default Value
name	String	Yes	none
Host name. If IP address is not specified, NetPinger uses this name to query DNS server and obtain IP address of the host.
ip	IP Address format	No	DNS query if not set
IP address of host. It is not required field. If IP address is not specified, NetPinger uses this host name to query DNS server and obtain IP address of the host.
timeout	Number	No	2000
Time [milliseconds] to wait for each reply.
interval	Number	No	1000
Time [milliseconds] that NetPinger waits after it receives reply from previous ping and before it sends another ping.
pingsbeforedead	Number	No	10
Number of unsuccessful pings before NetPingers declares host as dead.
buffersize	Number	No	32
Size [bytes] of echo message.
ttl	Number	No	32
Time To Live.
dontfragment	Boolean	No	false
Sets "Don't fragment flag" in IP packet.

Example

<pinger>

  <host>
    <name>localhost</name>
    <ip>127.0.0.1</ip>
    <timeout>300</timeout>
    <interval>2000</interval>
    <pingsbeforedead>5</pingsbeforedead>
    <buffersize>32</buffersize>
    <ttl>3</ttl>
    <dontfragment>false</dontfragment>
  </host>

  <host>
    <name>google.com</name>
    <timeout>2000</timeout>
    <interval>2000</interval>
  </host>

  <host>
    <name>some local host</name>
    <ip>192.168.0.1</ip>
    <timeout>500</timeout>
    <interval>2000</interval>
  </host>

  <host>
    <name>yahoo.com</name>
    <timeout>2000</timeout>
    <interval>2000</interval>
  </host>

</pinger>

Version 1.1

NetPinger version 1.1 configuration file introduces 3 new options:

Name	Type	Required	Default Value
description	String	No	none
Description of the host.
dnsinterval	Number	No	60000
Time [milliseconds] between unsuccessful try and new try to obtain host's IP address using DNS.
recenthistorydepth	Number	No	10
Number of sent pings used for recent history.