junkview README 2006-04-03, last edit 2008-08-13

what it is
```````````
A suite of awk and bash scripts to analyse iptables log files and provide 
summary information as a plain text report.  Now there's a perl script too.

See <http://bugsplatter.id.au/junkshow/> for an example.

requirements
`````````````
Iptables firewall with specially crafted logging directives that are read by 
the junkview script.  Development is on slackware-11.0.  Needs root access 
for install and use, since it reads the system log files.  

installation
`````````````
o  Extract tarball somewhere convenient, and cd into the install tree top 
   level where this README file is located

o  Check that etc/junkview.conf codepath and datapath locations are acceptable, 
   datapath will be created by the installer if required, all parts of junkview 
   use this file for reference.  

o  If updating to a newer version, the existing /etc.junkview.conf file will be 
   preserved.

o  As root, run ./install

o  Run 'junkview-update-database' as user if prompted, to optionally update the 
   database and to perhaps start the ip2cn-server.

o  Edit your iptables script to emit log events for the type of Internet 
   traffic you want to monitor with junkview.

install tree, no data
``````````````````````
.
|-- README
|-- bin
|   |-- ccfind
|   |-- ip2c-server
|   |-- junkshow
|   |-- junkview
|   |-- junkview-update-database
|   `-- logfile-date-filter
|-- data
|   |-- classify-text
|   `-- ip2c-names
|-- etc
|   `-- junkview.conf
|-- install
`-- rc.d
    `-- rc.junkview

5 directories, 14 files

download latest
````````````````
  <http://bugsplatter.id.au/junkview/archive/junkview-latest.tar.gz>

further information
````````````````````
home page:	<http://bugsplatter.id.au/junkview/>
updates:	<http://bugsplatter.id.au/junkview/archive/>
ip2cn-server	<http://bugsplatter.id.au/ip2cn/>

data source:	<http://software77.net/>

See also the header commentary in junkview, the sample junkshow cron job, and 
view other scripts as curiosity takes you.  Email the author with suggestions 
or patches.