---------------------------------------------------------------------------

    24 February 2004                  Jeffrey W. Baker <[email protected]>    

---------------------------------------------------------------------------

DESCRIPTION
-----------

This is Apache::Session 1.93

These modules provide persistent storage for arbitrary data, in arbitrary
backing stores.  The details of interacting with the backing store are
abstracted to make all backing stores behave alike.  The programmer simply
interacts with a tied hash.

COPYRIGHT AND LICENSE
---------------------

Apache::Session is Copyright (c) 1998, 1999, 2000, 2001, 2004  Jeffrey William
Baker <[email protected]>.  Distribute under the same terms as Perl itself.

Apache::Session is Copyright (c) 2004-2006 Casey West, <[email protected]>.
Disribute under the same terms as Perl itself.

Apache::Session is Copyright (c) 2007-2014 Alexandr Ciornii.
Disribute under the same terms as Perl itself.

PREREQUISITES
-------------

Required for testing: Test::More, Test::Deep, Test::Exception, File::Temp
Required for work: Storable, constant

Most of Apache::Session's functions require Digest::MD5.

If you wish to use the DBI backing stores, you need the latest version of DBI
and the driver for your database.  Currently MySQL, Postgres, and Oracle are
supported.

INSTALLATION
------------
Auto
Use CPAN's or CPANPLUS's shell.

Manual:


tar -xvzf Apache-Session-1.91.tar.gz
cd Apache-Session-1.91
perl Makefile.PL
make
make test
make install

Substitute "nmake"/"dmake" for "make" above if you are using Windows.

EXAMPLE
-------

See eg/example.perl.  This program is intended to be run under mod_perl.

AUTHORS
-------

Jeffrey Baker <[email protected]> is the author of 
Apache::Session.

Tatsuhiko Miyagawa <[email protected]> is the author of 
Generate::ModUniqueID and Generate::ModUsertrack

Erik Rantapaa <[email protected]> found errors in both Lock::File
and Store::File

Bart Schaefer <[email protected]> notified me of a bug in 
Lock::File.

Chris Winters <[email protected]> contributed the Sybase code.

Michael Schout <[email protected]> fixed a commit policy bug in 1.51.

Andreas J. Koenig <[email protected]> contributed valuable CPAN
advice and also Apache::Session::Tree and Apache::Session::Counted.

Gerald Richter <[email protected]> had the idea for a tied hash interface
and provided the initial code for it.  He also uses Apache::Session in
his Embperl module and is the author of Apache::Session::Embperl

Jochen Wiedmann <[email protected]> contributed patches for bugs and
improved performance.

Steve Shreeve <[email protected]> squashed a bug in 0.99.0 whereby
a cleared hash or deleted key failed to set the modified bit.

Peter Kaas <[email protected]> sent quite a bit of feedback
with ideas for interface improvements.

Randy Harmon <[email protected]> contributed the original
storage-independent object interface with input from:

  Bavo De Ridder <[email protected]>
  Jules Bean <[email protected]>
  Lincoln Stein <[email protected]>
  
Scott McWhirter <[email protected]> contributed verbose error messages for
file locking.

Corris Randall <[email protected]> gave us the option to use any table name in
the MySQL store.

Oliver Maul <[email protected]> updated the Sybase modules

Innumerable users sent a patch for the reversed file age test in the file
locking module.

Mike Langen <[email protected]> contributed Informix modules.

FURTHER INFORMATION:
--------------------

Apache   by Apache Group    comp.infosystems.www.servers.unix
                            http://www.apache.org/
                            
mod_perl by Doug MacEachern [email protected]
                            http://perl.apache.org/