aboutsummaryrefslogtreecommitdiff
path: root/nagios-exists.1
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2016-06-20 13:08:15 +1200
committerTom Ryder <tom@sanctum.geek.nz>2016-06-20 13:08:15 +1200
commitcdc34fa78b326bd241aae7399190c739e25bf025 (patch)
tree2d12fdf161b74dcde13baf33bb46f0137f443952 /nagios-exists.1
parentRemove silly symlinks (diff)
downloadnagscripts-mk-livestatus.tar.gz
nagscripts-mk-livestatus.zip
Update to latest version with MKLivestatusmk-livestatus
No longer using NDOUtils at work, these are much nicer and more likely to work with any given Nagios installation now anyway. Added nagios-data-search, nagios-downtstream-list, nagios-exists, nagios-problem-list, and nagios-unhandled-list.
Diffstat (limited to 'nagios-exists.1')
-rw-r--r--nagios-exists.129
1 files changed, 29 insertions, 0 deletions
diff --git a/nagios-exists.1 b/nagios-exists.1
new file mode 100644
index 0000000..9411cb6
--- /dev/null
+++ b/nagios-exists.1
@@ -0,0 +1,29 @@
+.TH NAGIOS-EXISTS 1 "Nagios Exists" "Nagscripts"
+.SH NAME
+.B nex, nagios-exists
+\- Return an exit status based on whether a host or host/service pair exists in
+Nagios, checked via a MK Livestatus socket.
+.SH USAGE
+.B nagios-exists
+-h
+.br
+.B nagios-exists
+.I HOSTNAME[/SERVICE]
+.SH SYNOPSIS
+.B nex
+webhost
+.br
+.B nex
+webhost/HTTP
+.SH DESCRIPTION
+.B nagios-exists
+will query a Nagios installation via a MK Livestatus socket to determine
+whether a host or a host/service combination exists. If it exists, it exits
+with 0; otherwise it exits with 1. Under normal circumstances, it produces no
+output; it's intended to be used in scripts.
+.P
+The path to the socket defaults to /usr/local/nagios/var/rw/live. It can be
+overriden by setting MK_LIVESTATUS_SOCKET in the script's environment.
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+.PP