mod_shm_counter.c
Copyright (c) 2002 Aaron Bannert
All rights reserved.

$Id: README,v 1.3 2002/06/18 04:59:07 aaron Exp $

This module generates a simple shared-memory counter for each hook phase,
to illustrate both the use of shared memory (anonymous and name-based)
and global mutexes. It simply counts the number of times each of this
modules' hooks are run.


Installation:

This is the quick and dirty installation. Support for external modules
in Apache right now is really poor, so hopefully this method will be
improved.

1. Install Apache version 2.0.36 or greater
2. Make sure you have DSO support enabled (--enable-so)
3. Run ./buildconf
4. Run ./configure
   (You must have Apache 2's apxs in your PATH, or you must
    specify its location using the --with-apxs2 flag to configure)
5. make
6. make install

Configuration:

1. This is the easy part. It works just like mod_info or mod_status, just
   insert a SetHandler in the location you want it to work from, and set
   the handler to be "shm-counter-handler", like this:

<Location /shm-counter>
  SetHandler shm-counter-handler
</Location>

