aboutsummaryrefslogtreecommitdiff
path: root/doc/ping903.8
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ping903.8')
-rw-r--r--doc/ping903.819
1 files changed, 10 insertions, 9 deletions
diff --git a/doc/ping903.8 b/doc/ping903.8
index 35cbb4a..f8967af 100644
--- a/doc/ping903.8
+++ b/doc/ping903.8
@@ -10,13 +10,13 @@
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Ping903. If not, see <http://www.gnu.org/licenses/>.
-.TH PING903 8 "March 11, 2020" "PING903" "System Administration"
+.TH PING903 8 "September 19, 2020" "PING903" "System Administration"
.SH NAME
ping903 \- high-performance ICMP monitoring daemon
.SH SYNOPSIS
\fBping903\fR\
[\fB\-fhsVv\fR]\
[\fB\-c \fIFILE\fR]
@@ -49,18 +49,19 @@ The program logs its activities using syslog channel \fBdaemon\fR.
The set of monitored IP addresses consists of two parts. The
.I immutable
IP list is supplied in the configuration file and cannot be altered at
run-time. The
.I mutable
IP list, in contrast, is maintained via the REST API and thus can be
-changed while the server runs. The content of mutable IP list is
+changed when the server runs. The content of the mutable IP list is
preserved during server restarts.
.PP
-Probes for each IP from the list are initiated periodically, each
+Each
.B probe\-interval
-seconds. Each probe consists of
+seconds, the daemon wakes up and probes each IP from the list. Each
+probe consists of
.B ping\-count
ICMP ECHO requests sent with intervals of
.B ping\-interval
seconds between each of them. Obviously, these three parameters must
satisfy the following relation:
.PP
@@ -73,16 +74,16 @@ number of received echo replies, percentage of lost requests,
minimal, average and maximal round-trip time, and its standard
deviation. If more than a predefined number of echo requests (the
failure \fItolerance\fR number) are lost, the status of the IP is
changed to "inactive".
.PP
An \fBHTTP\fR listener thread is responsible for returning the collected
-statistics and serving other requests. By default the program listens
-for queries on localhost, port 8080. If compiled with the support for
-\fBlibwrap\fR, the access to the HTTP interface can be controlled
-using files
+statistics and serving other requests. By default it listens for
+queries on localhost, port 8080. If compiled with the support for
+\fBlibwrap\fR, the access to the HTTP interface is controlled using
+the files
.B /etc/hosts.allow
and
.BR /etc/hosts.deny .
See
.BR hosts_access (5),
for details.
@@ -143,13 +144,13 @@ Turn on additional logging. This option can be given several times to
request more verbose output. If given single \fB\-v\fR option, the
program prints at the end of each probe the total number of echo
requests sent and replies received. Two options (\fB\-vv\fR), enable
additional diagnostics of invalid echo replies. Three options enable
logging of each received echo reply, and four options enable verbose
logging of each echo request sent. Notice that three or more
-\fB\-v\fR options can produce huge amount of logs.
+\fB\-v\fR options can produce a huge amount of output.
.SH BUGS
Only IPv4 is currently supported.
.SH SEE ALSO
.BR ping903.conf (5),
.BR ping903q (1).
.SH COPYRIGHT

Return to:

Send suggestions and report system problems to the System administrator.