Building
--------

Using the 'apxs' tool:

    $ apxs -i -c mod_scgi.c

Alternatively, you can use 'make' and 'make install'.


Configuration
-------------

To enable, add

    LoadModule scgi_module /<some path>/mod_scgi.so

in your httpd.conf file.  Note that it is best to load mod_scgi after
mod_rewrite (mod_rewrite needs a higher priority in order to rewrite
URLs served by mod_scgi).  You can serve a set of URLs under one path
using mod_scgi by using the Location directive:

    <Location "/dynamic">
        SCGIServer 127.0.0.1 4000
        SCGIHandler On
    </Location>

Alternatively, if the URLs served by a single SCGI server are not
under one path you can use the LocationMatch directive:

<LocationMatch "^/(dynamic|login)($|/)">
    SCGIServer 127.0.0.1 4000
    SCGIHandler On
</Location>

You can also use multiple SCGI servers:

<Location "/foo">
    SCGIServer 127.0.0.1 4000
    SCGIHandler On
</Location>
<Location "/bar">
    SCGIServer 127.0.0.1 4001
    SCGIHandler On
</Location>

If you have Quixote installed you can try out the demo application by
running "./scgi/quixote_handler.py -F".  If you don't have Quixote,
the scgi_server.py module implements a simple SCGI server that you can
also run from the command line.

Note: the MultiViews option and an SCGI handler should not be enabled
for the same directory, as this will prevent the SCGI handler from
being called.  

