Daily Usage Generation Package
==============================

*******************************************
This software is still alpha and incomplete
*******************************************

This is a small collection (2 at the moment) of tools to generate and maintain
daily usage logs and generate web usage graphs etc.  The tools are based around
a central 'usage generator' that generates useable usage information from wtmp
entries, records them to a log in a user-specified directory.  This information
is then used by the graphing tool to quickly and efficiently graph usage
information for a given day/week/month.

Requirements:
- The usage grapher requires the PERL GD library (available on the CPAN archive
  at a site near you).
- The PERL cgi-lib for the usage grapher to be useful over the web (it will 
  generate usage graphs and statistics on the command line)

In order to install this package (no it doesn't install itself yet), place the
tools somewhere useful like /var/lib/httpd/cgi-bin and add a cron entry for the
usage log generator wtmp something like

# generate usage log information
0 0 * * * /var/lib/httpd/cgi-bin/wtmp ttyS1 ttyS2 ttyS3

To get a usage graph try something like

daily:   http://localhost/cgi-bin/dailyusage.pl?tty=ttyS1,ttyS2,ttyS3
weekly:  http://localhost/cgi-bin/dailyusage.pl?tty=ttyS1,ttyS2,ttyS3&weekly=1
monthly: http://localhost/cgi-bih/dailyusage.pl?tty=ttyS1&monthly=1 

The tools currently generate and read usage information from
/usr/local/etc/usagelogs.  To change this edit wtmp.c and dailyusage.pl.

This software is covered by the gnu public license (included).

Please report any problems/fixes to me at 
c.nott@student.canberra.edu.au

Good luck :)

Chris Nott.
