This is the INSTALL file for mod_backhand.

For sample configurations and an explanation of various components please
visit http://www.backhand.org/.

Read the NOTES file to see if there are any particular "issues" with your
platform.

##########################################################
## Compiling and Install with the Apache source tree
#####################################################

For those of you who don't have perl... Hours were invested making sure that
all of this can be done with standard unix utilities (sh, cut, sed, wc, dc)

mod_backhand is not very large, so it doesn't have a stand alone install
process.

Run ./precompile to start the whole process off.  Once this script completes
successfully, you can just go to the apache source tree and ./configure like
you would have without mod_backhand.  (you will need to --enable some things,
but an example is provided)

./precompile installs mod_backhand in your apache source tree and updates the
various files to allow you to use the ./configure script accompanying apache.

An example ./configure command line is displayed after successfully running
the precompile script.

####################################################################
## Compiling and installing using apxs (post-Apache install)
#############################################################

Try (in the mod_backhand source directory):
/full/path/to/apache/bin/apxs -c -o mod_backhand.so apue.c arriba.c \
	back_util.c builtins.c mod_backhand.c
/full/path/to/apache/bin/apxs -c -o byHostname.so byHostname.c

###########################################
## Installing the binary packages..
#########################################

This isn't foolproof, and it is fairly dependent on how your apache was
compiled, so it may not work and you will have to recompile.

1) move mod_backhand.so and byHostname.so to your libexec directory.
2) move backhand-test to your CGI directory
3) move all the images (*.jpg) to your document root (htdocs).


Have fun!

-- Theo Schlossnagle <jesus@cnds.jhu.edu>
