diff -r 1c27769b8435 -r 022ee48c7409 mod_auth_form-2.05/README
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auth_form-2.05/README	Fri May 22 15:42:33 2009 +0100
@@ -0,0 +1,81 @@
+mod_auth_form
+Apache2 Form-Based Authorization Module
+----------------------------------------
+
+Overview
+--------
+
+This module is a form-based authorization module based on 
+'mod_auth_mysql' and 'mod_auth_sim'. It is used to place access
+restrictions on a per-directory, per-user-request basis using
+session management. The module uses a MySQL database to retrieve
+users' group membership, maintain and validate users' sessions,
+and optionally track user activity.
+
+The mechanics of the module works in the following way. A web
+client (user) requests for a restricted page/directory. The module
+sends back a 'Page Has Moved' error, pointing the client to the page
+containing a login form. Through server-side scripting, a session is
+created in the MySQL database and the client (i.e. cookies or query
+string). The session itself consists of a unique, random, and temporary
+ID that is associated with a user. The client then makes the same
+request along with the session ID (SID) and the user ID (UID). The
+module compares and validates the two IDs against the IDs stored in the
+MySQL database. If successful, the module sends back the requested
+page; otherwise, the module once again sends back the 'Page Has Moved'
+error page. In addition (if specified), the module will also validate
+the user's group membership and act accordingly.
+
+
+Requirements
+------------
+- Apache2 Web Server
+-- With Runtime Library (apr0 or apr1)
+- MySQL 4.1 or greater
+- Server-Side Scripting Processor
+-- Comes with MySQLi-Capable API
+
+
+Installation
+------------
+Please refer to INSTALL
+
+
+Configuration
+-------------
+Please refer to http://comp.uark.edu/~ajarthu/mod_auth_form
+
+
+Files In This Directory (Not Counting the AutoConf/AutoMake Generated Files)
+----------------------------------------------------------------------------
+autom4/
+	Contains various automake/autoconf support files.
+
+src/
+	Contains mod_auth_form's source code.
+
+win32/
+	Contains Visual Studio files for building under a
+	Windows environment.
+
+AUTHORS
+	The authors who contributed to mod_auth_form.
+
+ChangeLog
+	Record of changes made to mod_auth_form. 
+
+configure.in
+	Input file for 'autoconf' to generate 'autom4te.cache
+	and 'configure'.
+
+COPYING
+	Apache2 License Agreement.
+
+Makefile.am
+	Input file for 'automake' to generate 'Makefile.in'.
+
+NEWS
+	User visible changes made to mod_auth_form.
+
+README
+	This file.