
   [1][eto-small.gif] The master version is at
   [2]http://info.ost.eltele.no/freeware/squidGuard/faq.shtml
   This page was last modified on Wednesday, 28-Jul-1999 13:45:32 MET DST
   
   squidGuard Frequently Asked/Answered Questions (FAQ)
   [3][squidGuard.gif] 
   A free filter, redirector and access controller for Squid
   
   Note: this page is primarily written for squidGuard-1.0.x. Though most
   of it still applies to squidGuard-0.9.x.
   
Contents

     * [4]FAQ
     * [5]Copyright
     * [6]Feedback
     * [7]Authors
       
FAQ - Frequently Asked/Answered Questions

   Currently in semirandom order:
    1.
       
        How can I test timeconstraints 
                You can set a simulated start time with the
                -t yyyy-mm-ddTHH:MM:SS option:
                
              squidGuard -c test.conf -t 1999-12-31T23:59:30 -d <test.in>
                      test.out 2>test.log 
                      
                With the -t option squidGuard parses the given date&time
                and calculates an offset from the current time at startup
                and then adds this offset to all timevalues during
                runtime.
                
    2.
       
        squidGuard compiles fine and the tests succeeds, but it seems to
                pass all when run under Squid 
                There may be at leaste two reasons for this:
                
               o Some versions of Squid (supposedly 2.2.*) silently
                 ignores argumets to the right of
                 redirect_program prefix/bin/squidGuard. Solutions are
                 one of:
                    # Set the actual config file location at
                      [8]compiletime with --with-sg-config
                    # Use a shell wraper with
                      redirect_program prefix/bin/squidGuard.sh and make
                      prefix/bin/squidGuard.sh an executable shell like:
                      
                          #! /bin/sh -
                                  exec prefix/bin/squidGuard -c whatever/
                                  squidGuard.conf 
                                  
               o When run under Squid, squidGuard is run with the same
                 user and group ID as Squid (cache_effective_user and
                 cache_effective_group in squid.conf). The squidGuard
                 configuration and database files must be readable for
                 this user and/or group and the squidGuard log directory
                 must be writable for this user and/or group. If not
                 squidGuard will go into the "pass all for all" emergency
                 mode.
                 
    3.
       
        compilation of sg.l on fails with "sg.l:line ...: Error: Too many
                positions" with native lex 
                Some native versions of lex have problems with sg.l. The
                solution is to use [9]GNU flex wich is better anyway. Do
                "setenv LEX flex" if configure selects the native lex
                before flex. Flex should compile right out of the box
                similar to other GNU programs. (Thanks to
                laurent.foulonneau@mail.loyalty.nc).
                
    4.
       
        Are there any blacklist exchange plans? 
                There are no concrete plans currently. We would like to
                involve in such a project if someone could give us some
                clever solutions for how to tackle these problems:
                
               o How can we distribute blacklists without publishing the
                 ultimate Internet guide to banned sites?
                    # Should we use a registration scheme?
                    # Could a dual key systems like PGP help us here?
                    # Is a mailinglist the solution?
               o Spammers could blacklist "microsoft.com". (Fine with me,
                 but I'm sure the average user would complain..). How can
                 we avoid spammers attacks?
               o In some "free" countries suing people seems like a
                 public sport. What happens if we blacklist their fine
                 site?
               o Some URLs would be visually verified as bad content,
                 while others would come from dumb robots. Should they be
                 mixed?
               o At what level should we put the threshold? The opinion
                 on what is acceptable and not differs considerably, not
                 only between different parts of the world but also
                 within a community. Some think bikini/swimsuit pages
                 should be banned others think topless is OK..
               o What copyright should such a list have? Should we help
                 commercial competitors by feeding them with suspect
                 links, or should we put in some "water marks" to catch
                 abuse?
                 
                The sample blacklist included in the source distribution
                is the current compromise and a regularely updated
                version is now available in the distribution directory.
                We are planning to include our robot as a contrib in the
                next public release of squidGuard. A snapshot is
                available [10]here. There is currently no documentation
                for the robot.
                
    5.
       
        Can I use proxy authenticated user the same way as RFC931/Ident
                user? 
                If you patch Squid with this simple [11]diff, gently
                contributed by [12]Antony T Curtis, the authenticated
                user will be passed from Squid to squidGuard and the
                answer will be yes, otherwise no:
                
        A useful patch to Squid 2.2STABLE which fixes per-user redirection wher
e
        the user is authenticated using proxy-auth...

        *** src/redirect.c.orig Tue Jun 22 14:04:43 1999
        --- src/redirect.c      Tue Jun 22 15:46:41 1999
        ***************
        *** 103,108 ****
        --- 103,110 ----
              cbdataAdd(r, cbdataXfree, 0);
              r->orig_url = xstrdup(http->uri);
              r->client_addr = conn->log_addr;
        +     if (http->request->user_ident[0])
        +       r->client_ident = http->request->user_ident; else
              if (conn->ident == NULL || *conn->ident == '\0') {
                r->client_ident = dash_str;
              } else {


   If you have questions and/or answers that should be on the FAQ list
   please send them to [13]squidguard@ost.eltele.no
   
Copyright

   squidGuard is covered by the [14]GNU General Public Licence (GPL). The
   copyright boils down to:
     * You may use squidGuard in both free and commercial services
       without fee or registration to [15]ElTele st AS.
     * You may freely redistribute unchanged free copies of squidGuard;
       precompiled or in source form.
     * There is no warranty for squidGuard.
     * You may not change the copyright.
     * You may not sell or use squidGuard in a commercial software
       package without a written agreement with [16]ElTele st AS; and
       most likely with [17]Sleepycat too for the DB part.
       
   For more copyright details you have to read the [18]GNU General Public
   Licence (GPL).
   
Feedback

   If you find a bug, have a bug fix, a contribution, a question or a
   comment on squidGuard feel free to send it to
   [19]squidguard@ost.eltele.no
   
   The preferred bug fix format is context diff:
          diff -c origfile fixedfile
          
   or
          diff -cr origdir fixeddir
          
   Please explain what problem your diff fixes.
          
   Success reports are [20]very welcome too.. They makes [21]us even more
   enthusiastic!
   
Authors

   squidGuard was designed by [22]Pl Baltzersen and implemented by
   [23]Lars Erik Hland
   at [24]ElTele st AS and made freely available by permission of
   [25]ElTele st AS.
   
   This page is written and maintained by [26]Pl Baltzersen.
   Please [27]report any errors, broken links, missing stuff, typos,
   misspellings, wrong grammar, norwenglish phrases etc. you discover.
   
       [28][gnu-logo.gif] [29][perl-logo.gif] [30][solaris-logo.gif]
                 [31][sun-logo.gif] [32][eltele-logo.gif] 
                                      
      [33][apache-logo.gif] [34][squid-logo.gif] [35][squidGuard.gif] 
                                      
                             [36][identd.gif] 

References

   1. http://www.ost.eltele.no/
   2. http://info.ost.eltele.no/freeware/squidGuard/
   3. http://ftp.ost.eltele.no/pub/www/proxy/squidGuard/
   4. http://info.ost.eltele.no/freeware/squidGuard/faq.shtml#FAQ
   5. http://info.ost.eltele.no/freeware/squidGuard/faq.shtml#Copyright
   6. http://info.ost.eltele.no/freeware/squidGuard/faq.shtml#Feedback
   7. http://info.ost.eltele.no/freeware/squidGuard/faq.shtml#Authors
   8. http://info.ost.eltele.no/freeware/squidGuard/installation.html#Defaultconfigfile
   9. http://info.ost.eltele.no/freeware/squidGuard/#Flex
  10. http://info.ost.eltele.no/freeware/squidGuard/squidGuardRobot
  11. http://ftp.ost.eltele.no/pub/www/proxy/squidGuard/contrib/squid-2.2-authuser.patch
  12. mailto:antony@abacus.co.uk
  13. mailto:squidguard@ost.eltele.no?subject=SquidGuard%20FAQ?
  14. http://www.gnu.org/copyleft/gpl.html
  15. http://www.ost.eltele.no/
  16. mailto:squidguard@ost.eltele.no?subject=squidGuard%20licensing
  17. http://www.sleepycat.com/db/licensing.html
  18. http://www.gnu.org/copyleft/gpl.html
  19. mailto:squidguard@ost.eltele.no
  20. mailto:squidguard@ost.eltele.no?subject=SquidGuard%20success%20report
  21. mailto:squidguard@ost.eltele.no
  22. mailto:pal.baltzersen@ost.eltele.no
  23. mailto:leh@nimrod.no
  24. http://www.ost.eltele.no/
  25. mailto:info@ost.eltele.no
  26. mailto:pal.baltzersen@ost.eltele.no
  27. mailto:squidguard@ost.eltele.no
  28. http://www.gnu.org/
  29. http://www.perl.com/
  30. http://www.sun.com/solaris/
  31. http://www.sun.com/servers/
  32. http://www.ost.eltele.no/
  33. http://www.apache.org/httpd.html
  34. http://squid.nlanr.net/
  35. http://info.ost.eltele.no/freeware/squidGuard/
  36. http://info.ost.eltele.no/freeware/identd/
