NAME

pingmond - Ping Monitoring Daemon


SYNOPSIS

pingmond [-hvIL] [-d <dump interval>] [-F <output format>] [-H <time format>] [-i <interval>] [-l <log file path>] [-s <packet size>] [-W <ping timeout>] <destination>


DESCRIPTION

pingmond is a program which continually pings a target host. It generates logs of high/average/low ping time and packet loss averaged into specified time periods. It can log to text files or to syslog. Everything is adjustable via command line options.


OPTIONS

-d dump interval
Number of seconds between log entries.

-F output format
Log output format. This consists of a string which can contain special sequences beginning with a '%' characater to substitute data (like printf). The following '%'-sequences are available:

a - Average ping time.

h - High ping time.

l - Low ping time.

o - Number of packets lost.

O - Packet loss percentage.

r - Number of packets replied to.

s - Timestamp. Seconds elapsed since Jan 1 1970.

t - Human-readable timestamp, customizeable via -H.

The default output format when running as a daemon is ``%t: avg=%a;hi=%h;lo=%l loss=%O%% (%o/%r)''.

-h
Display command line help.

-H time format
Human-readable timestamp format. This takes a string identical to that take by the date(1) program and the strftime(3) C library function. See manual pages for those for characters valid in this string.

-i interval
Number of seconds to wait between ping packets sent.

-I
Run pingmond in the foreground rather than as a daemon. Logs will be produced on stdout.

-l log file path
Path to a textual log file that pingmond should log to.

-s packet size
Size (in bytes) of packets to send.

-L
Send output data (lines of ping statistics) to the daemon's logging mechanism. When running in the foreground (-I), logs will go to stdout. When running as a daemon, logs will go to syslog(3). If a data file is not specified with -l and pingmond is running as a daemon, this option will be implied.

-v
Show version number and exit.

-W ping timeout
Number of seconds to wait for a response to a ping. After this many seconds the packet will be considered lost.


AUTHOR

Steve Benson <steve@rhythm.cx>


SEE ALSO

the Net::Ping manpage ping(8)