#$Id: README,v 1.1 2003/01/22 14:36:23 dfs Exp $
#
# GraphDefang -- a set of tools to create graphs of your mimedefang
#                spam and virus logs.
#
# Written by:    John Kirkland
#                jpk@bl.org
#
# Copyright (c) 2002, John Kirkland
#=============================================================================

DESCRIPTION
-----------

GraphDefang is a perl utility that parses mimedefang or spamd syslog entries
and creates a set of configurable charts (png files) with the data.

The following attributes are definable:

	* Chart Type 	(stacked_bar or line)
	* Chart Time	(hourly, weekly, or monthly)
	* X-Axis	(Summary, Value1, Value2, Sender, Recipient, Subject,
			 or All)
	* Y-Axis	(any event logged with md_log within mimedefang-filter)
	* Top Number of Items to Display
	* Chart Title
	* Filter	

Graphdefang will also cache summary data so that it is not necessary
to parse and recalculate old data each time new graphs are drawn.

You can see the output in action at:

	http://www.westover.org/~jpk/spam

DOWNLOAD
--------

         http://www.bl.org/~jpk/graphdefang


REQUIRED PERL MODULES
---------------------

File::ReadBackwards
GD
GD::Graph
Date::Parse;
Date::Format;
MLDBM
Storable


INCLUDED FILES
--------------

graphdefanglib.pl  => Calculation and graphing routines.
graphdefang.pl     => Front-end perl script.
graphdefang-config-mimedefang-example 
                   => Example configuration file for use with mimedefang
graphdefang-config-spamd-example 
                   => Example configuration file for use with spamd
index.php          => Very simple php file to display the resulting png files
README             => This file
TODO               => Prioritized list of next things to work on.
COPYING            => Copy of the GPL


INSTALLATION INSTRUCTIONS
-------------------------

1.  Install Required Perl Modules

2.  Untar the graphdefang distribution into a directory from where it can run.

3.  (for mimedefang only) Add md_log commands per the example mimedefang-filter
    (included with mimedefang-2.22+).

4.  Create a file, graphdefang-config, from the examples included with the
    distribution.  Set $DATAFILE and $OUTPUT_DIR in this file.

5.  Copy index.php to the $OUTPUT_DIR web directory.

6.  Run graphdefang.pl via cron.  I run mine hourly.


LICENSE
-------
GraphDefang is released under the GPL license.  A copy of the GPL is
included in this distribution under the file, COPYING.
