Man Linux: Main Page and Category List

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)