Building
--------

Using the 'apxs' tool:

    $ apxs -i -c mod_scgi.c

Alternatively, you can use 'make install'.


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

To enable, add

    LoadModule scgi_module /<some path>/mod_scgi.so

in your httpd.conf file.  You can serve a set of URLs under one path
using mod_scgi by using the Location directive:

    <Location "/dynamic">
        SetHandler scgi-handler
        SCGIServer localhost: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)($|/)">
    SetHandler scgi-handler
    SCGIServer localhost:4000
    SCGIHandler On
</Location>

You can also use multiple SCGI servers:

<Location "/foo">
    SCGIServer localhost:4000
    SCGIHandler On
</Location>
<Location "/bar">
    SCGIServer localhost:4001
    SCGIHandler On
    SCGIServerTimeout 10
</Location>
<Location "/bar/images">
    SCGIHander Off
</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 (e.g. "./scgi/scgi_server.py 4000").
