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 <sherzodr@cpan.org>. 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 <sherzodr@cpan.org>, 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