Http-handler

http-handler BETA v2.4
http://www.unsatisfactorysoftware.co.uk
chris()unsatisfactorysoftware.co.uk

== VERY IMPORTANT == READ THIS ENTIRE DOCUMENT BEFORE PROCEEDING ==
This is BETA software.  All use is ABSOLUTELY AT YOUR OWN RISK, with NO WARRANTY
either expressed or implied.  It almost certainly WILL CRASH or BEHAVE
UNPREDICTABLY.  If you value your data, especially data you haven't saved yet,
DO NOT INSTALL THIS SOFTWARE.  There is a more stable version available on
OS4Depot and Aminet designed for mass consumption.  This BETA software should
ONLY be used for testing and bug reporting purposes. and MUST NOT be used in a
production environment.

It offers a number of changes and improvements over the previous release.  This
beta is released now as it brings the v2 beta up to the standard of the latest
v1 (see below for changes summary).  Information here supercedes the original
documentation, but in other cases the original documentation should still be
correct.  Installation is by hand only, just update l:http-handler from the v1
install.  Installation script is intentionally not provided.

* WebDAV is now supported.  This is the main change.  However, it is probably
not useful for most people because md5 (digest) authentication is NOT
implemented yet.  Therefore, the highest level of security is not available and
you won't be able to access most WebDAV resources.  You can get a test WebDAV
account that supports this lower permission set at http://www.sharemation.com
although changing permissions does not seem to be possible on Amiga browsers.

Most WebDAV commands will work.  Locking is only implemented at a local
filesystem level - lock commands do not pass down to the WebDAV server yet. 
AmigaOS locks do NOT work with non-WebDAV mounts (ie. a standard HTTP: mount),
although you can toggle this with the httpmode command at your peril.

* WB volumes are now supported, for WebDAV mounts only.

* The STARTUP mount parameter template has changed.  It is now
PROXY/K,NAME/K,PROTOCOL/K,URL/K,TIMEOUT/K/N,AUTH/K
PROXY specifies the proxy server, NAME specifies the volume name (leave blank
for no WB volume), PROTOCOL is not documented, URL is the path to the WebDAV
resource - trailing slash might be required - and TIMEOUT is the timeout in
seconds.

AUTH is the credentials for basic authentication.  This is a base64 encoded
string of the form "user:pass".  There is a base64 encoder in the
codesets.library package, and doubtless countless others on Aminet.  This is
very basic and does not offer feedback for incorrect passwords

* Summary of changes since v2.1beta:
- Addition of TIMEOUT and AUTH parameters
- SSL support via AmiSSL3
- Now supports 307 redirects
- New custom packet 2050 (HTTPACTION_READ_HEADER)

* Known bugs
- ASSIGN DISMOUNT can crash the system and take everything else down with it.
- Some filenames do not display properly and may not be accessible in certain
circumstances.
- Some things are not implemented yet, such as datestamps.  Certain Amiga DOS
packets were causing problems with various programs and have been disabled:
including but not limited to SameLock(), DupLock().
- In certain circumstances http-handler has been known to go into a loop, which
might take the whole system down.

* There is NO SUPPORT.  However, feel free to report new bugs to
chris()unsatisfactorysoftware.co.uk

* This package MUST NOT be distributed further.

-----BEGIN PGP MESSAGE-----
Version: 2.6.3in

iQB7AwUART/lSLO1+24s2ZO5AQHf7wMsDWyt3ypD0GWiyUusYwK4SbAB2Ttjo4UO
KYE9LS6JrIFS8CqU3fO54PaV80FSmjNHTlEWrKjOcZMRVp7X21VYmqlTmbuufJn3
kdGkKBGu67ysUD9tt7B810MeDRdGZT+GSry1DGS2
=oFaZ
-----END PGP MESSAGE-----