
1. How to Compile and Install:

    BSD platform:
	% make
	# make install

    Linux and other non-BSD platform:
	at this moment, it isn't our priority to improve the support 
	of non-BSD platforms.  but you can try:
	 1.  install tcpdump(1) and libpcap(3) available from
	     http://www.tcpdump.org/
	 2.  edit Makefile and uncommnet "COMPAT_INCLUDES".
	     edit other lines as needed.
	 3.  provide missing library calls if there is any.

    by default,
	aguri	is installed into /usr/local/bin
	aguri.1	is installed into /usr/loca/man/man1
	other perl scripts are installed into /usr/local/lib/aguri
	    note that the perl scripts assume
	     - the perl path is /usr/bin/perl
	     - the gnuplot path (for creating png images) is
		/usr/local/bin/gnuplot
	    you might need to change these paths in the scripts
	    or set symbolic links.

2. How to Use:
	(most people use only agurify.pl script so that you can skip
	 this section.)

    To read a saved tcpdump file:
	aguri -r dumpfile

    To read from an interface:
	aguri -i ifname

    To read aguri files:
	aguri file1 file2 ...

    To run X11 animation:
	(X11 animation is compile option,  you need edit Makefile to
	 set -DXTREE, X11 includes and library.)

	aguri -r dumpfile -a [-g geometry]

    To archive aguri outputs:
	edit "scipts/agurify.pl" and run it from cron(8) every 5 minutes.

    To create graphs:
	use "scripts/makeimages.pl", "scripts/makeplot.pl" or
	"scripts/density.pl".

3. How to Archive Aguri Outputs and Create Web Pages:

    Use "scripts/agurify.pl".
    Edit $logdir variable to specify the directory for archive.
	(by default, /var/log/auri.log, so you can set a symbolic link.)

    run agurify.pl from cron(8) every 5 minutes.
    The following is an example of a crontab entry to read from fxp0:
    (use crontab(1).  aguri needs root privilege to read packets from BPF.)

		# archive aguri log every 5 minutes
		*/5 * * * *     /usr/local/lib/aguri/agurify.pl -i fxp0

    The script also creates daily/weekly plot image and index.html files,
    and updates them hourly.
    (agurify.pl calls makeimages.pl and makeplot.pl to create png plots.)
    If you don't want images, set $create_images to 0 in agurify.pl.

    Disk Space Requiremetns:
	agurify.pl creates a summary every 5-minutes.
	A summary output size about 5KB.
	(note that the size of a summary varies depending on traffic.)
	So,
		1 hour:	 ~60KB
		1 day:	 ~1.4MB
		1 month: ~44MB
		1 year:	 ~520MB

	If you save the original summaries created at every 10-seconds,
	it consumes additional 200KB for 5 minutes.
		1 hour:  ~2.4MB
		1 day:	 ~56MB
		1 month: ~1.7GB
		1 year:  ~20GB

4. How to Plot Graphs:

    By default, agurify.pl automatically creates graph images.
    but you can use "scripts/makeimages.pl" or "scripts/makeplot.pl"
    directly to create images.
