aboutsummaryrefslogtreecommitdiff
path: root/nagios-exists.1
blob: 9411cb6a99bf022c8767faff2c2e32f44f7a112d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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