********************************************************************************
				SafeSquid-Proxy
********************************************************************************

Safesquid is a robust proxy server with many features designed to  remove unwanted  content, increase privacy, 
and to simply make surfing the Web a more pleasant experience. 

Some of the highlights include:
- an intutive Web interface to configure the proxy server.
- banner and popup blocking.
- HTTP and FTP content caching.
- virus scanning using ClamAV or F-Prot.
- bandwidth throttling and usage limits.
- regular expression substition in downloaded files and HTTP headers.
- regular expression subitution on requested URLs.
- many URL commands to temporarily change proxy settings and to view information about a requested file.
- complete HTTP/1.1 support including persistent connections and gzip encoding.
- URL blacklist support for allowing or denying content is certain categories.
- Squid log format for generating usage reports using many available tools.
- config synchronization to ease managing a cluster of proxy servers.
- ICP, CARP, and ICAP support to interoperate with other proxy servers.

********************************************************************************
				Installation
********************************************************************************

Just run the "install" with this package 
./install

If the installer was unable to add safesquid as a startup service automatically, you may manually
start the proxy server by typing "/etc/init.d/safesquid start". Refer to your distro's documentation
on how to get it started at boot.

Safesquid is dynamically linked against an older version of libstdc++, this makes it more compatable between different
Linux distributions, but may not work without some additional steps on newer distributions.

You'll need whatever package provides the library "libstdc++-libc6.2-2.so.3"


********************************************************************************
				Configuring your browser
********************************************************************************

If you choose not to use transparent proxying, you will need to configure every browser on your network to use
the proxy server. 

To configure Internet Explorer, follow these steps:
- select 'Internet Options...' from the Tools menu.
- select the 'Connections' tab.
- click on the 'LAN Settings' button.
- select the 'Proxy server' checkbox.
- fill in the 'Address' and 'Port' fields with the IP address and port of your proxy server.

To configure Konqueror, follow these steps:
- select "Configure Konqueror..." from the Settings menu.
- select the Proxy icon in the left menu.
- click the 'Manually specify proxy settings' radio button.
- click the 'Setup' button next to it.
- fill in the HTTP field with 'http://server_ip' where server_ip is the IP address of the proxy server.
- fill in the field next to it with 8080 or whatever port Safesquid is listening on.
- click the 'Use the same proxy server for all protocols' checkbox.
- click OK.

To configure Mozilla Firebird, follow these steps:
- select 'Preferences' from the edit menu.
- click the 'Connection settings...' button.
- click the 'Manual proxy configuration' radio button.
- fill in the HTTP, SSL, and FTP field with the IP address of the proxy server, and the Port field next to them with the
  port Safesquid is listening on.
- click OK.

********************************************************************************
				Configuring Safesquid
********************************************************************************

Safesquid can be configured through a Web interface. You can access it by loading
http://server_ip:8080/safesquid.cfg if your browser isn't configured to use the proxy server, or
http://safesquid.cfg if it is. 

********************************************************************************
				Documentation and Support
********************************************************************************

Documentation on all the available options in the Web interface is available at www.safesquid.com

If you have any questions that couldn't be answered by reading the documentation, feel free to visit
the Safesquid forum at http://www.safesquid.com/forum/index.php and submit a question.

You may also find the HOWTO document included in this package helpful.

********************************************************************************
				Navigating the Web interface
********************************************************************************

The Web interface is without a doubt the most powerful and unique feature available in Safesquid. 
It provides a means of configuring the proxy server through an intuitive interface, 
and to also examine the current state of the proxy server. 

I'll start by describing the purpose of each linked-to page in the top navigation menu.

- Active connections - Displays a list of transfers that are currently in progress.
- Statistics - Displays various statistics about the proxy server's performance, such as memory usage, cache hits, etc.
- DNS cache - Display a list of cached DNS results, this is mostly for debugging purposes and should be ignored by the casual user. 
- Show headers - Display the headers sent by your browser before and after filtering.
- View cache entries - This page allows you to see the current state of memory an disk caches, as well as let you search for specific 
  files in the cache and optionally delete them.
- Connection pool - Safesquid keeps persistent connections in a pool for later reuse to improve response time, 
  this page shows a list of those connections.
- Prefetch queue - Displays a list of files waiting to be prefetched, as well as giving you the option to add new files to that list.
- URL blacklist - Displays all categories in the URL blacklist and allows you to search through some or all of them.
- Config - Configuration, explained in more detail below.
- View log entries - Display recent log entries (all messages except debug, regardless of command line options used) and allows 
  you to search through them.
- Save settings - Save current settings to specific file.
- Load settings - Load settings from specific file, the overwrite option specifies whether or not the settings 
  are merged with the current ones, or simply replaces them.

The Config page is where all the interesting stuff happens. You will be presented with a drop-down list containing all the sections, 
from here you select which section you wish to configure then click submit.

The details of all the available configuration options is beyond the scope of this writing, but I will describe things that are 
common between all sections. 

On each section's main page, at the top you will see some global options, usually accompanied with an Enabled option first. 
The enabled option can be used to enable or disable the feature for everyone.

Below the global options, there may be one or more lists (called subsections), 
each list starts with a header giving the subsection name and an Add link to add a new entry to that list. 

Every entry in every list will have 6 links at the bottom: Edit, Delete, Up, Down, Top, and Bottom.
- The edit link will bring you to a page where the contents of that entry can be edited.
- The delete link will delete that entry from the list.
- The Up and Down links will be that entry to up or down in the list.
- The Top and Bottom links will move that entry to the top or bottom of the list.

Entries in most sections have at least these options in common:
- Enabled - enables or disables the entry.
- Comment - A text comment describing the entries purpose.
- Profiles - A comma-seperated list of profiles this entry is in, an entry not in any profiles will always match.

Tooltips are used throughout the Web interface to provide context-senstive help.


********************************************************************************
		Solution for error: libstdc++-libc6.2-2.so.3 not found

********************************************************************************
-Download compat-libstdc++-7.3-2.96.126.i386.rpm from any location on the following page:
http://rpm.pbone.net/index.php3/stat/4/idpl/1306231/com/compat-libstdc++-7.3-2.96.126.i386.rpm.html

Depeding on your distro these are following steps:
- Install the RPM package compat-libstdc++-7.3-2.96.126.i386.rpm with command
rpm -ivh compat-libstdc++-7.3-2.96.126.i386.rpm 

For  Redhat 9.0, Fedora core 3, Trustix 2.1 

wget -c -nH ftp://mirror.switch.ch/mirror/fedora/linux/core/2/i386/os/Fedora/RPMS/compat-libstdc++-7.3-2.96.126.i386.rpm
rpm -ivh compat-libstdc++-7.3-2.96.126.i386.rpm

For Suse :

wget  -c -nH  http://www.safesquid.com/download/precompiled/safesquidlib/SuSe-9.0/compat-2003.5.12-60.i586.rpm
rpm -ivh --nodeps  compat-2003.5.12-60.i586.rpm

For Debian...
wget -c -nH ftp://mirror.switch.ch/mirror/fedora/linux/core/2/i386/os/Fedora/RPMS/compat-libstdc++-7.3-2.96.126.i386.rpm
alien -d compat-libstdc++-7.3-2.96.126.i386.rpm
dpkg -i compat-libstdc++_7.3-3.96_i386.deb

For Gentoo..........
emerge lib-compat 

NOTE: Alternatively manullay copy the libstdc++-libc6.2-2.so.3 file into /usr/lib/ directory of your system

********************************************************************************		
	PAM Authentication in SUSE 9.0 
********************************************************************************
-You need to install Safesquid with user=root and group=root  by editing installtion script 
 for PAM authentication to work ...



