README file for SquidClamav Version 1.4

SquidClamav - A Clamav Antivirus Redirector for Squid -
		http://www.samse.fr/GPL/squidclamav/


Recquirement :
--------------

You need ClamAv version 0.82 and libcurl 7.12.1 at least.
Here the libraries linkage I use :

-lclamav -lcurl -ldl -lssl -lcrypto -ldl -lz -lbz2 -lgmp -lpthread


Installation instructions :
---------------------------

cd regex/
./configure
make
cp regex.h regex.o ../
cd ..
make
make install

Note: If you want more verbose output edit file path.h and uncomment
the line with debug definition.

Edit file path.h to match your needs, especially these lines:

#define LOG_FILE "/usr/local/squidclamav/logs/squidclamav.log"
#define REDIRECT_PATTERNS "/usr/local/squidclamav/etc/squidclamav.conf"
#define MY_PROXY "http://127.0.0.1:3128"

If you want debug information uncomment definition of DEBUG.


Squid configuration :
---------------------

To integrate squidclamav to your squid cache just edit the squid.conf
file and set the following:

	redirect_program /usr/local/squidclamav/bin/squidclamav
and
	redirect_children 10

If you have huge access and enough memory set the redirect_children to
upper value.

and add this acl to prevent loops

	redirector_access deny localhost

SquidClamAv configuration:
--------------------------

See README file.

Virus Database:
---------------

SquidClamAv load ClamAv Virus datase once at startup, to tell to SquidClamAv
to reload the database, just killall squidclamav, (kill -15). Do this after
each freshclam call.


If you find it useful, I'd like to know - please send email
to gilles@darold.net


This project is a modified version of the excellent Squirm Redirector for Squid
Maintained by Chris Foote, and copyrighted as follow :

        Copyright (C) 1998 Chris Foote & Wayne Piekarski

The original Squirm version used was squirm-1.0betaB. Some other parts are
cut and paste from the ex1.c program given in the ClamAv distribution and
are copyrighted: Copyright (C) 2002 - 2004 Tomasz Kojm

All other code: Copyright (C) 2005 Gilles Darold - Groupe SAMSE

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Please see the file GPL in this directory for full copyright
information.

