================================================================================
This is a README file for the free-sa program, version 1.5.0 or higher

    Copyright (C) 1997, 2006-2008 Oleg Sapon <xsov@mail.ru>

    This file is part of free-sa.

    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 3 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, see <http://www.gnu.org/licenses/>.

    For tranlations authors check THANKS file.
================================================================================

Free-SA is statistic analyzer for daemons log files similar to SARG. Its main 
advantages over SARG are much better speed (7x-20x times), more reports support,
crossplatform work and W3C compliance of generated HTML/CSS reports code. It's 
written in C and is free part of commercially available RBSec-SA suite. You may 
check platform requirements in README.DEV file.

Free-SA objectives:
- Control of users traffic usage;
- Help IT security officers to control internet access security policies and
  investigate IT security incidents;
- Evaluate server efficiency to detect troubles with configuration;
- Be crossplatform and generate W3C compliant reports.

Free-SA currently support following log formats:
    -	Squid 2.x native log format,
    -	CERN/NCSA Common Log Format (CLF),
    -	CERN/NCSA Combined Log Format (in similar to CLF way),
    -	Postfix 2.x over syslog log format (EXPERIMENTAL),
    -	Qmail over syslog log format (EXPERIMENTAL),
    -	NetCache via Squid 2.x native log format (EXPERIMENTAL);
    -	Blue Coat via Squid 2.x native log format (EXPERIMENTAL);
    -	Communigate pro 5.x native log format (VERY EXPERIMENTAL).

IMPORTANT NOTICE: FREE-SA IS LOCALE DEPENDENT! IT MEANS:
* FREE-SA LOCALE SHOULD BE EQUAL TO PROXY LOCALE
  (you can play with LC_ALL shell variable at free-sa side)
* FREE-SA TIMEZONE SHOULD BE EQUAL TO PROXY TIMEZONE 
  (you can play with TZ shell variable at free-sa side)
* RUNTIME LOCALE CHARSET FOR FREE-SA SETS CHARSET FOR ALL HTMLs
  (you can use iconv to convert translation files at free-sa side)
