aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ping903q.120
1 files changed, 18 insertions, 2 deletions
diff --git a/doc/ping903q.1 b/doc/ping903q.1
index 5da343d..84bd850 100644
--- a/doc/ping903q.1
+++ b/doc/ping903q.1
@@ -13,7 +13,7 @@
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Ping903. If not, see <http://www.gnu.org/licenses/>.
-.TH PING903Q 1 "February 27, 2020" "PING903Q" "User Commands"
+.TH PING903Q 1 "March 5, 2020" "PING903Q" "User Commands"
.SH NAME
ping903q \- ping903 query tool
.SH SYNOPSIS
@@ -24,6 +24,7 @@ ping903q \- ping903 query tool
[\fIIP\fR]
.PP
\fBping903q\fR\
+ [\fB\-N\fR]\
[\fB\-f \fIFILE\fR]\
[\fB\-p \fIPREFIX\fR]\
[\fB\-R \fIREALM\fR]\
@@ -83,7 +84,7 @@ request, without sending unauthorized request first and consulting the
reply.
.SH EXIT CODE
When called with one argument, the program exits with code 0 (success)
-if the IP is alive and 2 otherwise.
+if the IP is alive, 2 if it is not, and 3 if the host status is unknown.
.PP
When called without arguments, the program exits with code 0 if all
monitored IP addresses are alive, 2 if none of them is reachable and 1
@@ -99,6 +100,16 @@ Warning condition.
.TP
.B 2
Critical condition.
+.TP
+.B 3
+Unknown. This code is returned in the following cases: (1) the host
+is not monitored by the
+.B ping903
+server, (2) the server replied with a HTTP code other than 200 or the
+reply was otherwise non-compliant, and (3) if the server has not
+yet collected enough data for that host and the command line option
+.B \-N
+was given.
.PP
In match mode, the program exits with code 0 if the requested host is
monitored by the server, and with code 2 if it is not.
@@ -155,6 +166,11 @@ arguments.
.PP
Other options valid in this mode:
.TP
+\fB\-N\fR
+By default hosts in initial state (i.e. for which no data has been
+collected) are treated as "OK" (exit status 0). This option changes
+the default to treat them as "UNKNOWN" (exit status 3).
+.TP
\fB\-p \fIPREFIX\fR
Supplies the prefix to be displayed before Nagios status string. The
default is "PING". The \fIPREFIX\fR string can contain the

Return to:

Send suggestions and report system problems to the System administrator.