Content-type: text/html

# squid_session

Section: Maintenance Commands (8)
Updated: 19 March 2006
Index Return to Main Contents

## 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)

## Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLE
AUTHOR
QUESTIONS
REPORTING BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: GMT, June 01, 2008