About SqStat
============

SqStat is a script which allows to look through active squid users connections. It use cachemgr protocol to get information from squid proxy server. Script homepage is http://samm.kiev.ua/sqstat/.

What's new
==========

For a complete list of changes, see the CHANGES file.

System requirements
===================

PHP (you need PHP 4.1.0 or newer) with installed "pcre" extension

Squid proxy server

a web-browser (doh!)

(optional) PHP session extension if you want to see current/average CPS

Installation
============    

1. Unpack the distribution in your webserver's document root.

2. Copy file config.inc.php.defaults to config.inc.php, edit config.inc.php to specify your squid proxy server IP and port.

3. Edit your squid.conf to allow cachemgr protocol:

   acl manager proto cache_object

   replace 10.0.0.1 with your webserver IP

   acl webserver src 10.0.0.1/255.255.255.255 http_access allow manager webserver http_access deny manager

4. Point your browser to sqstat.php file and see what happens :)

5. (optionally) enable ip resolving in config.inc.php. Also you can make "hosts" like file with ip->name pairs.

Bug reports

===========

If you have found what you believe to be a bug, you can send a bug report to samm [at] os2.kiev.ua. Please, read FAQ before reporting.