NAME
   CGI::Session - persistent session data in CGI applications

SYNOPSIS
       # Object initialization:
       use CGI::Session;
       $session = new CGI::Session();

       $CGISESSID = $session->id();

       # send proper HTTP header with cookies:
       print $session->header();

       # storing data in the session
       $session->param('f_name', 'Sherzod');
       # or
       $session->param(-name=>'l_name', -value=>'Ruzmetov');

       # retrieving data
       my $f_name = $session->param('f_name');
       # or
       my $l_name = $session->param(-name=>'l_name');

       # clearing a certain session parameter
       $session->clear(["l_name", "f_name"]);

       # expire '_is_logged_in' flag after 10 idle minutes:
       $session->expire('is_logged_in', '+10m')

       # expire the session itself after 1 idle hour
       $session->expire('+1h');

       # delete the session for good
       $session->delete();

DESCRIPTION
   CGI-Session is a Perl5 library that provides an easy, reliable and modular
   session management system across HTTP requests. Persistency is a key feature
   for such applications as shopping carts, login/authentication routines, and
   application that need to carry data across HTTP requests. CGI::Session does
   that and many more.

COPYRIGHT
   Copyright (C) 2001-2005 Sherzod Ruzmetov <[email protected]>. All rights reserved.
   This library is free software. You can modify and or distribute it under the same
   terms as Perl itself.

AUTHOR
   Sherzod Ruzmetov <[email protected]>, http://author.handalak.com/

SEE ALSO
   *   CGI::Session::Tutorial - extended CGI::Session manual
   *   RFC 2965 - "HTTP State Management Mechanism" found at
       ftp://ftp.isi.edu/in-notes/rfc2965.txt
   *   CGI - standard CGI library
   *   Apache::Session - another fine alternative to CGI::Session