NAME¶
bb-findhost.cgi - Xymon CGI script to find hosts
SYNOPSIS¶
bb-findhost.cgi?host=REGEX
DESCRIPTION¶
bb-findhost.cgi is invoked as a CGI script via the bb-findhost.sh CGI
wrapper.
bb-findhost.cgi is passed a QUERY_STRING environment variable with the
"host=REGEX" parameter. The REGEX is a Posix regular expression (see
regex(7) ) describing the hostnames to look for. A trailing wildcard is
assumed on all hostnames - e.g. requesting the hostname "www" will
match any host whose name begins with "www".
It then produces a single web page, listing all of the hosts that matched any of
the hostnames, with links to the Xymon webpages where they are located.
The output page lists hosts in the order they appear in the
bb-hosts(5)
file.
A sample web page implementing the search facility is included with bbgen, you
access it via the URL /bb/help/bb-findhost.html.
OPTIONS¶
- --env=FILENAME
- Loads the environment from FILENAME before executing the
CGI.
FILES¶
- $BBHOME/web/findhost_header
- HTML header file for the generated web page
- $BBHOME/web/findhost_footer
- HTML footer file for the generated web page
- $BBHOME/web/findhost_form
- Query form displayed when bb-findhost.cgi is called with no
parameters.
ENVIRONMENT VARIABLES¶
- BBHOSTS
- bb-findhost.cgi uses the BBHOSTS environment variable to
find the bb-hosts file listing all known hosts and their page locations.
- BBHOME
- Used to locate the template files for the generated web
pages.
SEE ALSO¶
bbgen(1),
bb-hosts(5),
hobbitserver.cfg(5)
