this was written for a debian system....but it should be trivial to
modify for use with other linux/unix boxes.

here's what you need to do to install it:

(note: if /usr/lib/squid is not correct for your system then take
appropriate action)


1. copy Makefile, gen.squid.redir, and redir into /usr/lib/squid

redir is the 'database' of redirections. you'll need to understand perl
regular expressions if you want to add your own redirection rules.

gen.squid.redir is a perl script which reads in redir and generates
another perl script called 'squid.redir'. squid.redir is the program
which actually does the redirection for squid.

the Makefile automates the process of building squid.redir and
restarting squid. squid needs to be restarted whenever you add new
redirection rules.


2. copy dot.gif and closeme.html into your web server's document root.
probably /var/www

(this is optional. if you're not running a web server then you'll just
get broken gif icons. dot.gif is a single-pixel transparent gif file)

3. edit gen.squid.redir so that $BASE_URL equals the base URL for
dot.gif, closeme.html, and do_nothing.js on your web server. note that
you shouldn't specify the protocol.

WHATEVER YOU DO, *DO NOT* SPECIFY MY SERVER (taz.net.au) AS THE BASE
URL.  I RUN A PROXY TO MINIMISE BANDWIDTH WASTAGE, AND IT DEFEATS THE
PURPOSE IF PEOPLE ON THE NET USE MY SERVER WHEN THEY SHOULD BE USING
THEIR OWN.  I'M REALLY SICK AND TIRED OF TELLING PEOPLE THIS.  IT SHOULD
BE BLOODY OBVIOUS.


e.g.
	$BASE_URL="//localhost" ;
	$BLANK="$BASE_URL/dot.gif" ;
	$CLOSEME="$BASE_URL/closeme.html" ;
	$NULLJS="$BASE_URL/do_nothing.js" ;

4. check /usr/lib/squid/redir.
   this is the 'database' containing all the banner redirections. make
   changes here.

5. edit squid.conf to enable redirection.   you'll want a line like the
   following:

        redirect_program /usr/lib/squid/squid.redir


6. ok, that should be installed now. the slightly hard bit is generating
the squid.redir perl script from the redir file, and then automatically
restarting squid.

The Makefile included with the .tar.gz file does both of these things
automatically.  All you need to do is make sure you're in the right
directory and then run "make".

	cd /usr/lib/squid
	make

if you ever want to add a new banner URL regexp to redir, just edit
/usr/lib/squid/redir and run make.



CREDITS:

Simon Rumble <simon@rumble.net> and Cloudmaster aka Danny Sauer
<sauer@cloudmaster.ml.org> both had the great idea of writing a web
page which contained some javascript code to kill the geocities popup
windows.  Cloudmaster provided a working example, so i've included it in
this latest version.  Thanks, guys!