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)