How to add modules to Apache
----------------------------

To add a module to the Apache server, you need to edit the file
``Configuration'' in the source directory.  There are two things to
consider:

1) Does the extension need any extra libraries to be linked in?

   If yes, then add the name of these libraries to the EXTRA_LIBS variable
   in the file.  For example, to link the mSQL authentication package,
   you need to add -lmsql to the list.  If your library is in a
   non-standard location, you will also need to specify the path using
   the -L/path/to/lib/dir option before the -l option.


2) Does the extension need any extra include paths to find header files?

   If the include files needed by the module are in a non-standard
   place, then chances are you will need to add the path to those
   files to the compile command.  For example, if the header files for
   the mSQL authorization package are in /usr/local/Minerva/include,
   then you will probably need to add -I/usr/local/Minerva/include to
   the CFLAGS variable in the ``Configuration'' file.



Next, copy the source file for the module to the Apache src directory.
Now you must add the module to the list of modules.  This is as simple
as adding a line like this to the ``Configuration'' file:

     Module module_name module_code.o

where the tag ``Module'' tells the Configure program this is a line
describing a module, the ``module_name'' is as defined in the source
code.  Look for a line that is something like this:

     module msql_auth_module = {

followed by some definitions.  This is the name of that module.  The
``module_code.o'' tells the build process the name of the object file
containing the code to implement the module.  This is the same as the
name of the source file with the ``.c'' replaced by ``.o''.

Run ``Configure'' followed by a ``make'' and the new module will be
added into the httpd program.