aboutsummaryrefslogtreecommitdiff
path: root/nagios-exists.1
diff options
context:
space:
mode:
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