2 =======================================
11 =======================================
12 This application provides means to check the availability of remote hosts
13 through pings to them.
17 ---------------------------------------
18 The application uses ICMP echo requests messages to verify if a given host
21 The host's address can be an IP or a DNS.
25 ---------------------------------------
26 There are many ways to invoke the application, the simplest is just type:
28 which uses the configuration values from the configuration file (describled in
29 the Configuration File section).
33 ---------------------------------------
34 Further information about the problem domain can be found in the References
39 ---------------------------------------
40 All rights reserved to Intra2net AG.
45 =======================================
46 In this section are describled the configuration items, along with they
47 possible values and meanings. This section is organized in each major
52 ---------------------------------------
53 This configurations are shared among and affect all the hosts.
54 - source-network-interface: the local network interface from where the ping
55 packages with originate.
56 - nameserver: the server which the hosts names will be resolved. It is the
57 lookup server which the application will query first. If left blank or omited,
58 it will use the /etc/resolv.conf.
59 - hosts-down-limit: an absolute number, which ranges from 0 to the number of
60 hosts available. This value represents the minimum number of hosts that have
61 to fail (i.e. do not reply to the ping) in order to alert any external system.
62 - ping-fail-limit: percentage of pings to a host that can fail. If the
63 percentage of failed pings to a host exceed this number, then the host is
65 - status-notifier-cmd: the command line that is called when a host is down, or
66 up. Accepted variables are:
67 ${status} - down or up
68 - link-up-interval: how long (in minutes) the pings must be returned with
69 success in order to consider the link up, or stable.
70 - link-down-interval: how long (in minutes) the pings must fail, in order to the
71 application consider the link down.
75 ---------------------------------------
76 - name: the DNS or IP of the host to ping. Take in consideration that, if a
77 DNS is given, the application pings all IPs in the look up table, however, if
78 IP is provide, it is the only which will be pinged.
79 - interval: the host will be pinged every "interval" seconds.
84 =======================================
85 The command line accepts the general configuration file options plus the
87 - config-file: command line to specify a file where the hosts and other
88 configuration information are provided.
93 =======================================
94 [1] http://tools.ietf.org/html/rfc792
95 [2] http://en.wikipedia.org/wiki/Ping
96 [3] http://en.wikipedia.org/wiki/Internet_Control_Message_Protocol
97 [4] http://www.boost.org/doc/libs/1_45_0/doc/html/boost_asio.html
98 [5] http://www.boost.org/doc/libs/1_45_0/doc/html/program_options.html