README

   1 Sarg is a Squid Analysis Report Generator that allow you to view "where" your users
   2 are going to on the Internet.
   3 Sarg generate reports in html, with many fields, like: users, IP Addresses, bytes, sites and times.
   4
   5 Support to SmartFilter added - 09/02/2000
   6
   7 Special thanks to:
   8 Matteo Colombo <matteo@calcol.it>                       - Italian language
   9 Palamarchuk Eugen <eugen@cit.od.ukrtel.net>             - Russian language
  10 Csaba Kabai <ckabai@icnpharm.com>                       - Hungarian language
  11 Evren Yurtesen <yurtesen@ispro.net.tr>                  - Turkish language
  12 Andreas Piek <a.piesk@gmx.net>                          - German language
  13 Fred Pacquier <fredp@dial.oleane.com>                   - French language
  14 Leonardo A. D'Angelo <ldangelo@san-cayetano.com>        - Spanish language
  15 Seth Mos <stimpy@stimpy.multiweb.nl>                    - Dutch language
  16 Milos Prudek <prudek@nembv.cz>                          - Czech language
  17 Dima I. Allaverdov <allav@ur.rags.ru>                   - Russian_windows1251 language
  18 V Gatut Harijiso <gatut@student.unpar.ac.id>            - Indonesian language
  19 Ivan Minchev <vanko@uni-svishtov.bg>                    - Bulgarian_windows1251 language
  20 Akira Kitamura <click@anet.ne.jp>                       - Japanese language
  21 Radovan Drobnjakovic <admin.rts@rts.co.yu>              - Serbian language
  22 Pieter Kooistra <pkooistra@hr.nl>                       - Dutch language fix
  23 Andrew Okhmat <andy@crgu.com>                           - Russian Koi8 language fixed
  24 Nikolai V. Ivanyushin <koko@infocenter.bryansk.ru>      - Russian and Bulgarian language fix
  25 Juris Valdovskis <juris@auce.lv>                        - Latvian language
  26 Jordan Kanev <dancho@globcom.net>                       - Bulgarian language fix
  27 Wszebor Boksa <Wszebor_Boksa@koncept.pl>                - Polish language
  28 Adi Cretu <adi@usv.ro>                                  - Romanian language
  29 Roman Vynar <rvynar@icqmail.com>                        - Ukrainian_windows1251 language
  30 Andreu Sanchez <tanis@lleida.com>                       - Catalan language
  31 Antonis Maglaras <vegos@magla.gr>                       - Greek language
  32 Dusan Woletz <Dusan.WOLETZ@orange.sk>                   - Slovak Language
  33 Jose Luis Hernandez <jhdz@simbiotica.net>               - Spanish language fix
  34 Theo kastermans <t.kastermans@zandvoort.nl>             - Dutch language fix
  35 Alex Deiter <tiamat@komi.mts.ru>                        - Russian UTF-8 language
  36 Josef Karliak <karliak@ajetaci.cz>                      - Czech UTF-8
  37 Igor Ageikin <iageikin@lipen.elektra.ru>                - Russian UTF-8 fix
  38
  39 Translating
  40    . Copy include/English to YourLanguage
  41    . Translate YourLanguage
  42    . Send YourLanguage to    pedro.orso@gmail.com to be implemented.
  43
  44
  45 If you use native squid log format, the elapsed time will be in reports (emulate_httpd_log off).
  46
  47 1. run ./configure
  48
  49    configure options: --bindir=where sarg binary will be saved
  50                                 default: /usr/local/bin
  51
  52                       --sysconfdir - where the configuration directory is
  53                                 default: /usr/local/etc
  54
  55                       --mandir - where the sarg man page will be saved
  56                                 default: /usr/local/share/man
  57
  58                       --enable-htmldir - where the www html root dir is
  59                                 default: /var/www/html
  60
  61                       --enable-languagedir - where the translation of sarg are
  62                                 default: /usr/local/share/sarg/languages
  63
  64                       --enable-fontdir - where to find the fonts for the reports
  65                                 default: /usr/local/share/sarg/fonts
  66
  67                       --enable-imagedir - where sarg take the images to include in the reports
  68                                 default: /usr/local/share/sarg/images
  69
  70                       --enable-extraprotection - compile sarg with extra GCC options for increased security
  71                                 default: use standard compilation warnings and no protection
  72
  73 3. make
  74
  75 4. make install
  76
  77 5. Go to /usr/local/sarg (or file entered with --sysconfdir on configure)
  78    and change sarg.conf as you need.
  79
  80 6. Notes about sarg:
  81
  82    Date/Time report:
  83          Every minute that a request is logged your time is incremented by the smaller
  84          of 1 minute or the total time for the requests.
  85
  86 Usage: sarg -h
  87
  88 Source: http://www.sarg-squid.org
  89
  90 Any suggests and/or comments, please:    pedro.orso@gmail.com