bb-findhost.cgi(1) [debian man page]

BB-FINDHOST.CGI(1)					      General Commands Manual						BB-FINDHOST.CGI(1)

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)

Xymon							    Version 4.2.3:  4 Feb 2009						BB-FINDHOST.CGI(1)

BB-CSVINFO.CGI(1)					      General Commands Manual						 BB-CSVINFO.CGI(1)

NAME

       bb-csvinfo.cgi - CGI program to show host information from a CSV file

SYNOPSIS

       bb-csvinfo.cgi

DESCRIPTION

       bb-csvinfo.cgi  is  invoked  as	a CGI script via the bb-csvinfo.sh CGI wrapper.  Based on the parameters it receives, it searches a comma-
       separated file for the matching host, and presents the information found as a table.

       bb-csvinfo.cgi is passed a QUERY_STRING environment variable with the following parameters:

	  key (string to search for, typically hostname)
	  column (columnnumber to search - default 0)
	  db  (name of the CSV database file in $BBHOME/etc/, default hostinfo.csv)
	  delimiter (delimiter character for columns, default semi-colon)

       CSV files are easily created from e.g. spreadsheets, by exporting them in CSV format. You should have one host per  line,  with	the  first
       line  containing  the  column headings. Despite their name, the default delimiter for CSV files is the semi-colon - if you need a different
       delimiter, invoke bb-csvinfo.cgi with the "delimiter=<character>" in the query string.

Example usage
       This example shows how you can use the bb-csvinfo CGI. It assumes you have a CSV-formatted file with information about the hosts stored	as
       $BBHOME/etc/hostinfo.csv, and the hostname is in the first column of the file.

       Use with the bbgen --docurl
	      The  --docurl  option to bbgen(1) sets up all of the hostnames on your Xymon webpages to act as links to a CGI script. To invoke the
	      bb-csvinfo CGI script, run bbgen with the option

		 --docurl=/cgi-bin/bb-csvinfo.sh?db=hostinfo.csv&key=%s

SEE ALSO

       bb-hosts(5), hobbitserver.cfg(5), bbgen(1)

Xymon							    Version 4.2.3:  4 Feb 2009						 BB-CSVINFO.CGI(1)