
mod_curb v1.1
-------------


About
-----
 
   This is a simple module which is designed to limit the total bandwidth
  a server may serve.

   Currently this works globally upon the server, and doesn't allow per
  virtual host tweaking.  This will almost certainly change in the future.


Installing
----------

  Build as per any module .. there that was simple, wasn't it?  ;)

  If you're running Debian GNU/Linux, or RedHat and you have the apache-dev
 package you should be able to build with the supplied makefile:

  user@host$ make -f Makefile-dev

  Failing that you'll have to rebuild your copy of apache from source,
 using something like the following incantation:

         ./configure --add-module=../mod-curb-1.0/mod_curb.c  \
         --enable-shared=curb --enable-shared=status --enable-module=so 
		 	

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

   Include something like this in your configuration file:


   # Bandwidth limiting requires mod_status
   LoadModule status_module libexec/mod_status.so
   ExtendedStatus on

   LoadModule mod_curb /usr/lib/apache/1.3/mod_curb.so

   <IfModule mod_curb.c>
     BandWidthExceeded http://www.some.com/exceeded.php
     BandWidthLimit 650Mb
     BandWidthMonitorURL /status/
   </IfModule>

   One you start your server you may track the data that is being transferred
  in real time by visiting http://server:port/status/


Notes
-----

   When the bandwidth limit is served nothing will work - so add a cronjob
  to restart the server every day, or hour, or whatever..


Steve
---
www.steve.org.uk
