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">
        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)($|/)">
    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>


Demo
-----

Quixote >= 2.0a2 has a demo application you can try out by running:

  python $QUIXOTE/server/scgi_server.py --port 4000 --script-name=/dynamic

with the appropriate path for $QUIXOTE.  If you have Quixote 1.3 or
2.0a1 installed, use the driver bundled with SCGI instead:

  python scgi/quixote_handler.py -F

If you don't have Quixote, the SCGI server doubles as a standalone
demo:

  python scgi/scgi_server.py 4000

