SYNOPSIS

wwwoffle-ls (<dir>/<subdir> | <protocol>://<host> | <URL>)
wwwoffle-mv (<dir1>/<subdir1> | <protocol1>://<host1>)

            (<dir2>/<subdir2> | <protocol2>://<host2>)
wwwoffle-rm <URL>
wwwoffle-read [--removeheader] <URL>
wwwoffle-write [--addheader] <URL>
wwwoffle-hash <URL>
wwwoffle-fsck
wwwoffle-gunzip ( <dir>/<subdir> | <protocol>://<host> ) ...
wwwoffle-gzip ( <dir>/<subdir> | <protocol>://<host> ) ...

DESCRIPTION

These eight commands can be used from the command line to inspect the wwwoffle cache, to move the cached pages around and to remove the cached pages from the cache. Using the wwwoffle HTML interface is much better and can be done even by normal users.

wwwoffle-ls

list the files in the directory in the style of 'ls -l'. For example use 'wwwoffle-ls http/foo' to list the URLs cached in the directory http/foo.

wwwoffle-mv

To rename a host directory in the spool to another name. Because the URL is encoded in the filename just renaming the directory will not work. Instead of 'mv http/foo http/bar' use 'wwwoffle-mv http/foo http/bar'.

wwwoffle-rm

Delete the URL that is specified on the command line. To delete all URLs from a host it is easier to use 'rm -r http/foo' than using this.

wwwoffle-read

Read data directly from the cache for the URL named on the command line and output it on stdout.

If --removeheader is used, the HTTP header will be removed for you.

wwwoffle-write

Write data directly to the cache for the URL named on the command line from stdin. Note this requires a HTTP header to be included first or browsers may get confused.

     (echo "HTTP/1.0 200 OK";
      echo "Content-Type: text/html";
      echo "" ; cat bar.html ) |
     wwwoffle-write http://www.foo/bar.html

If --addheader is used, the above header will be generated for you, so that the data can be redirected without the need for the echoes above.

If a different header is required, it will have to be generated externally as in the example above.

This should only be done as the user "proxy", else the file can't be written (in case of a normal user), or the file can't be removed later (in case of doing this as root).

wwwoffle-hash

Print WWWOFFLE's encoding of the submitted URL. This is useful for scripts working on the WWWOFFLE cache.

wwwoffle-fsck

Check the cache for inconsistent filenames and fix them.

wwwoffle-gzip, wwwoffle-gunzip

Compress or uncompress the cached copy of the specified URLs.

FILES

/var/cache/wwwoffle  default wwwoffle cache

AUTHOR

Written by Federico Di Gregorio <[email protected]>
Updated by Paul Slootman <[email protected]>