#-------------------------------------------------------
#
# $Id: README,v 1.2 1997/04/06 08:41:38 mergl Exp $
#
#-------------------------------------------------------


DESCRIPTION:
------------

This is version 0.2 of Apache::DBI.pm.

This module is supposed to be used with the Apache daemon together with an 
embedded perl interpreter like mod_perl. It provides authentication via Perl's 
DBI initiating a persistent database connection. With the first database 
access the connection to the database is established. It remains open for the 
lifetime of the httpd and supersedes the time consuming connect and disconnect 
with standard CGI for every database access. The persistent database connection
can also be used without authentication. 



USAGE:
------
Add the following configuration line to httpd.conf or srm.conf: 

 PerlModule Apache::DBI

For using authentication use the following entries in .htaccess: 

 AuthName DBI
 AuthType Basic

 PerlAuthenHandler Apache::DBI

 PerlSetVar AuthDBIDB     dbname
 PerlSetVar AuthDBIUser   username
 PerlSetVar AuthDBIAuth   auth
 PerlSetVar AuthDBIDriver driver

 PerlSetVar AuthDBIUserTable table
 PerlSetVar AuthDBINameField user
 PerlSetVar AuthDBIPasswordField password

 <Limit GET POST>
 require valid-user
 </Limit>

You may also use 'require user xxx' but there is no support for 
'require group xxx'.

For using a persistent database connection you have to replace in your perl 
scripts the command: 

          use DBI;
with
          use Apache::DBI;

Also replace every 

         DBI->connect()
with
         Apache::DBI->connect()



INSTALLATION:
-------------

1.   perl Makefile.PL
2.   make
4.   make install



IF YOU HAVE PROBLEMS:
---------------------

Please send comments and bug-reports to <E.Mergl@bawue.de>

Please include the output of perl -v,
           and the output of perl -V,
              and the version of DBI,
                and the used database
in your bug-report.



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

Apache   by Apache Group    http://www.apache.org/

mod_perl by Doug MacEachern <dougm@osf.org>
                            http://www.osf.org/~dougm/apache/

DBI      by Tim Bunce       <Tim.Bunce@ig.co.uk>
                            http://www.hermetica.com/technologia/DBI/



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

   Edmund Mergl <E.Mergl@bawue.de>                       April 10, 1997

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