Provided by: lusca_0.1~svn14809-1ubuntu1_amd64 bug

NAME

       squid_session - Squid session tracking external acl group helper

SYNOPSIS

       squid_session [-t idle_timeout] [-b dbpath] [-a]

DESCRIPTION

       This helper maintains a concept of sessions by monitoring requests and timing out sessions
       if no requests have been seen for the idle timeout timer.

       Intended use is for displaying "terms of use" pages, ad popups etc.

       -t idletimeout (default 3600)
              Specifies the session idle timeout timer.

       -b dbpath
              Path to persistent database. If not specified the session details will be  kept  in
              memory  only  and  all  sessions  will  reset each time Squid restarts it's helpers
              (Squid restart or rotation of logs).

       -a     Active mode. In this mode sessions are  started  by  evaluating  an  acl  with  the
              argument LOGIN, or terminated by the argument LOGOUT.

       Without this flag the helper automatically starts the session after the first request.

EXAMPLE

       Configuration example using the default automatic mode

              external_acl_type  session ttl=300 negative_ttl=0 children=1 concurrency=200 %LOGIN
              /usr/local/squid/libexec/squid_session

              acl session external session

              http_access deny !session

              deny_info http://your.server/bannerpage?url=%s session

       Then set up http://your.server/bannerpage to display  a  session  startup  page  and  then
       redirect the user back to the requested URL given in the url query parameter.

AUTHOR

       This helper and documentation was written by Henrik Nordstrom <henrik@henriknordstrom.net>

QUESTIONS

       Any questions on usage can be sent to Squid Users <squid-users@squid-cache.org>.

REPORTING BUGS

       Report  bugs  or  bug-fixes  to  Squid  Bugs <squid-bugs@squid-cache.org> or ideas for new
       improvements to Squid Developers <squid-dev@squid-cache.org>

SEE ALSO

       squid(8)