Provided by: xymon_4.3.0~beta2.dfsg-9.1_amd64 bug

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)