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

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)

HOBBITCGI.CFG(5)						File Formats Manual						  HOBBITCGI.CFG(5)

NAME

       hobbitcgi.cfg - Command-line parameters for the Xymon CGI tools

SYNOPSIS

       $BBHOME/etc/hobbitcgi.cfg

DESCRIPTION

       hobbitcgi.cfg(1) controls the commandline options passed to all of the Xymon CGI tools through their respective shell-script wrappers. Typ-
       ically the options listed here are used for system-wide configuration of the CGI utilities, e.g. to define where  they  read  configuration
       files.

       The exact set of commandline options available are described in the man-page for each of the CGI utilities.

       The file is "sourced" into the shell script wrapper, so assignments to the CGI-specific variables must follow standard shell-script syntax.

SETTINGS

       CGI_ACKINFO_OPTS
	      Options for the hobbit-ackinfo.cgi(1) utility.

       CGI_ACK_OPTS
	      Options for the bb-ack.cgi(1) utility.

       CGI_CSVINFO_OPTS
	      Options for the bb-csvinfo.cgi(1) utility.

       CGI_DATEPAGE_OPTS
	      Options for the bb-datepage.cgi(1) utility.

       CGI_ENADIS_OPTS
	      Options for the hobbit-enadis.cgi(8) utility.

       CGI_EVENTLOG_OPTS
	      Options for the bb-eventlog.cgi(1) utility.

       CGI_FINDHOST_OPTS
	      Options for the bb-findhost.cgi(1) utility.

       CGI_HIST_OPTS
	      Options for the bb-hist.cgi(1) utility.

       CGI_HOBBITCOLUMN_OPTS
	      Xymon-specific  options for column documentation. This uses the bb-csvinfo.cgi(1) utility with the server/etc/columndoc.cfg configu-
	      ration file.

       CGI_HOBBITCONFREPORT_OPTS
	      Options for the hobbit-confreport.cgi(1) utility.

       CGI_HOBBITGRAPH_OPTS
	      Options for the hobbitgraph.cgi(1) utility.

       CGI_HOSTGRAPHS_OPTS
	      Options for the hobbit-hostgraphs.cgi(1) utility.

       CGI_NKEDIT_OPTS
	      Options for the hobbit-nkedit.cgi(1) utility.

       CGI_NKVIEW_OPTS
	      Options for the hobbit-nkview.cgi(1) utility.

       CGI_REPLOG_OPTS
	      Options for the bb-replog.cgi(1) utility.

       CGI_REP_OPTS
	      Options for the bb-rep.cgi(1) utility.

       CGI_SNAPSHOT_OPTS
	      Options for the bb-snapshot.cgi(1) utility.

       CGI_SVCHIST_OPTS
	      Options for the hobbitsvc.cgi(1) utility when used to view historical logs. Note that the "--historical" option must be included	in
	      this setting.

       CGI_SVC_OPTS
	      Options for the hobbitsvc.cgi(1) utility.

SEE ALSO

       xymon(7), the individual CGI utility man-pages.

Xymon							    Version 4.2.3:  4 Feb 2009						  HOBBITCGI.CFG(5)