MOD_AUTH_COOKIE_MYSQL1

Introduction
============

  This module is written for apache 1.3. If you are using apache 2.0
  please refer to the following website to get the appropriate module:

      http://home.digithi.de/digithi/dev/mod_auth_cookie_mysql/

  If you are using apache 1.3 it is although a good idea to visit

      http://home.digithi.de/digithi/dev/mod_auth_cookie_mysql/

  where you can get further documentation, configuration samples,
  tips and help for this module.

  There are many ways to configure, compile and install this module.
  In this file the most common ways are described, the installation as a
  statically into apache compiled module and as DSO (Dynamic shared Object).

REQUIREMENTS
============

  To compile this module you need

    * gcc, make
    * apache 1.3 webserver and its development files
    * mysql database and its development files

  To compile the module statically into your apache, you need the source code
  of the webserver.

  To compile the module as DSO you need apxs and the development libraries and
  header files of your version of the apache webserver.
  
INSTALLATION
============

  * Installation as static module:

    You can use the configure script in your apache source code directory. Use the
    following command line to invoke the configure script. You can add your own
    options after these line.

	LDFLAGS="-L/usr/local/mysql/lib/" \
        LIBS="-lz -lmysqlclient" \
        INCLUDES="-I/usr/local/mysql/include" \
        ./configure --add-module=<path to module>/mod_auth_cookie_mysql1.c
  
    Please adapt the paths to your mysql libraries/includes so that your compiler
    can find all needed libraries and header files.

    Now you can build your apache webserver with

        make

    and install it with
   
       make install


  * Installation as DSO:

     Use the following command to compile the module as DSO.

       apxs -q -lmysqlclient -lz -L/usr/local/mysql/lib/ \
       -I/usr/local/mysql/include/ <path to module>/mod_auth_cookie_mysql1.c

    Please adapt the paths to your mysql libraries/includes so that your compiler
    can find all needed libraries and header files.

    After the command finished successfully you can copy the compiles module

      mod_auth_cookie_mysql1.so 

    to the "modules/" directory of your apache webserver and activate it by adding

      LoadModule auth_cookie_mysql1_module modules/mod_auth_cookie_mysql1.so
      AddModule mod_auth_cookie_mysql1.c

    to your httpd.conf.

    Thats it, after a restart of the apache webserver the module should be loaded
    automatically.

    

CONFIGURATION
=============
  
  Now its time to look at the configuration samples at the following website:

      http://home.digithi.de/digithi/dev/mod_auth_cookie_mysql/

  There you can hopefully find the documentation of all configuration directives
  and configuration samples.

QUESTIONS
=========

  If you have further questions, comments etc. Please the website of this module

      http://home.digithi.de/digithi/dev/mod_auth_cookie_mysql/

  where you can find a discussion board, a mailing list etc. or contact me by
  E-Mail at apache-mod{at}digithi.de .