|author||Sergey Poznyakoff <email@example.com>||2020-03-05 11:39:29 +0200|
|committer||Sergey Poznyakoff <firstname.lastname@example.org>||2020-03-05 11:39:29 +0200|
ping903q: improve output in Nagios mode; treat initial state as OK
New option -N is provided to treat the initial state as UNKNOWN as in previous versions.
Diffstat (limited to 'doc')
1 files changed, 18 insertions, 2 deletions
diff --git a/doc/ping903q.1 b/doc/ping903q.1
index 5da343d..84bd850 100644
@@ -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"
ping903q \- ping903 query tool
@@ -24,6 +24,7 @@ ping903q \- ping903 query tool
@@ -83,7 +84,7 @@ request, without sending unauthorized request first and consulting the
.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.
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.
+Unknown. This code is returned in the following cases: (1) the host
+is not monitored by the
+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
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.
Other options valid in this mode:
+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).
Supplies the prefix to be displayed before Nagios status string. The
default is "PING". The \fIPREFIX\fR string can contain the