How to use the Apache throttling module
=======================================

After installing the module as described in the INSTALL file,
the module should be ready for use.  Simply edit the logfile
argument in the httpthrottle.conf file to point to the bandwidth log
file you wish to use.  The format of this logfile is very simple:
plain text, where each line represents the average bandwidth for
exactly one second in kbit/s.  E.g.,

  1000
  1200
  2000

represents a three second log, where the bandwidth for the first
second is 1000 kbit/s, 1200 kbit/s for the next, and 2000 kbit/s
for the third second.  The clock starts running after the first
download.  To reset the test session, restart Apache.  If the
duration of the log is T seconds and the elapsed test time is
greater than T, then the throttling is disabled (i.e., no artificial
bandwidth limiting).

NOTE: to use the logs provided in the dataset paper, the log format
must first be converted to the pure kbit/s log format described above.
This is done using make_pure_bwlog.pl (included here), e.g.:

  ./make_pure_bwlog.pl report.2010-09-21_1622CEST.log > bw.log

bw.log can now be used as input by httpthrottle.py.
