Patches for WWWOFFLE Version 2.6.d
----------------------------------

Author: Jan Lukoschus <jan+wof@lukoschus.de>
Date:   2001-08-31

The proxy server software WWWOFFLE is created by Andrew M. Bishop
<amb@gedanken.demon.co.uk>.  The official homepage of WWWOFFLE is

  http://www.gedanken.demon.co.uk/wwwoffle/

I have extended WWWOFFLE with some more or less useful new features. These are:

- wwwoffle-hash: An addition to wwwoffle-tools which print WWWOFFLEs idea
of URL encryption. It is usefull for shell scripts working on the spool,
since the days of a simple MD5 are long gone.

- process status: In the process table (viewed with 'ps') the binary name
and command line parameters of WWWOFFLE server processes are replaced by
the URLs handled by those processes along with connection status and
download percentage. Very useful for monitoring the fetching mode.

- spool archive: This enables WWWOFFLE to read archived spool directories
when a requested page could not be found in the primary spool. Since this
patch enables WWWOFFLE only to read those archived spool directories, even
'/cdrom' is possible.

The patch files are named:

  wwwoffle-2.6d.tgz.j1-hash.diff
  wwwoffle-2.6d.tgz.j2-status.diff
  wwwoffle-2.6d.tgz.j3-spool.diff

They are independent of each other and should be applicable in any
order, but I have tested only the former order. If you are not
familiar with patching, take the following statements as a hint:

    # unpack the original WWWOFFLE archive
  tar xzf /somedir/wwwoffle-2.6d.tgz

    # change working dir into WWWOFFLE source dir
  cd wwwoffle-2.6d

    # Unpack patches
  tar xzf /somedir/wwwoffle-2.6d-jl-patch-1.0.tgz

    # Apply some or all patches
  patch -p1 < wwwoffle-2.6d.tgz.j1-hash.diff
  patch -p1 < wwwoffle-2.6d.tgz.j2-status.diff
  patch -p1 < wwwoffle-2.6d.tgz.j3-spool.diff

The patch program will print out some minor line offsets, they can
safely be ignored. Now you can continue with the usual procedure of
compilation and installation as described in the WWWOFFLE
documentation.

Here are some more comments on the patches and possible problems:

- wwwoffle-hash: This is only a minor patch and should not make any
problems. There are no operating system specific features used.

- process status: The patch is based on the fact, that a process can
overwrite it's own command line parameters and environment
settings. Those changes are visible to the 'ps' command. I have tested
this only with Linux, I have no information if this works with other
UNIXes or WIN32. A quick check with SUN/SOLARIS indicates that it does
NOT work.

- spool archive: This patch is a bit more intrusive and I hope it does
not break too much. Use this patch with care and make a backup of your
WWWOFFLE cache before using this patch!  I have introduced a new
config section named 'SpoolArchive' into wwwoffle.conf. It contains
the directories used as archive spools.  This section is documented in
the (patched) manual page for wwwoffle.conf.
