
Cups page_log Analyzer
######################################################################

Author:          G.K. Grubert (grubert@physik.uni-greifswald.de)
Version:         1.2
Last modified:   Jul 2008
License:         GPLv2

######################################################################


This program analyzes the page_log file of the cups
printing system and creates an html statistics output
about the printer usage as well as the user's
printed pages.


Requirements
------------
- perl
- perl modules: Getopt::Std
                GD::Graph::pie
                CGI


Usage
-----
Call the script from the command line. The option -h gives
an overview about all possible parameters:

-h   print help screen
-a   alias file for usernames (default: none)
-p   outputpath for gif-files (default: /tmp)
-o   html-outfile, enter WITHOUT .html!!! (default: /tmp/pages.html)
-f   page_log file (default: /var/log/cups/page_log)


Example
-------
./pagelog_analyzer.pl -f /tmp/page_log -p /home/user/ \
                      -o /home/user/pages -a alias.conf

This creates the statistics output of the logfile /tmp/page_log
into /home/user/ with the html file /home/user/pages.html.
The alias information file is used (see following section).


alias.conf
----------
It is possible, that the same user is listed in the logfile
with different usernames due to the login on different machines.
The alias file allows the definition of such aliases. It has
the following structure:

master1   alias1
master1   alias2
master2   alias2

This means, that all users "alias1" and "alias2" in the logfile
are counted as user "master1".


main.css
--------
This style file is used to configure the html output.
