packages icon



 squid_session(8)                Version 1.0                squid_session(8)
                                19 March 2006



 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>.



                                    - 1 -      Formatted:  November 29, 2021






 squid_session(8)                Version 1.0                squid_session(8)
                                19 March 2006



 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)















































                                    - 2 -      Formatted:  November 29, 2021