rrdbar v0.1
-----------

1. What is it?

rrdbar is a simple CGI Perl script that generates a (graphic) bar showing the
current status of a variable monitored by an RRDTool database.
You can use it to provide a compact summary of a current system's status.

2. How do I install it?

You will need RRDTool v1.0.24 or later, Perl 5 or later, and the Perl GD 
librarys.  Put the .conf file in a sensible place (eg, /usr/local/etc) and
put this path in the rrdbar.cgi.pl file.  Then put your rrdbar.cgi file into
your cgi-bin directory.
Configure your .conf file to point to the location of the RRD databases.
Put links on yuor web pages of the form:

<IMG SRC="/cgi-bin/rrdbar.cgi?RRD=foo.rrd&DS=ds0">

3. What options are there?

You can set a lot of parameters in the .conf file.  The sample .conf file 
has comments showing you the options you can put in there.
On the command line, the CGI parameters are:

RRD : Specify the RRD file (within the default directory)
DS  : Specify one or more data sources, separated by space.  A prefix of '-'
      will specify that the data source is to be shown as a line (not a bar).
      A prefix of '+' or '@' will stack the bars.  NOTE THAT SPACE AND THE +
      SYMBOL NEED TO BE ESCAPED IN CGI.
      Default is 'ds0 -ds1'
T   : Specify the time interval. Default '5min'.  This is not too reliable.
MAX : Specify the maximum upper bound for the data.  This represents 100% of
      the bar.  If multiple DSs, either give one (to be used for all) or a list.
LAB : Labelstyle. 0=none, 1=xx%, 2=nnnn, 3=nnnn (xx%).
WID : Bar width (height).
LEN : Bar length

4. Where can I get support/help/find the most up-to-date version?

Email bug reports etc to steve.shipway@Adsweu.com
New versions can be found on http://ukpavu99.adsweu.com/pub

