Cadaver for OS/2
================

1. Introduction

   This is a rough, three-quarters-of-an-evening port of  Cadaver v 0.23.0 to
   OS/2, used  previously  to  automate  off-site  backups  to an  ISP-hosted
   "web folder" that ended up  in neglect. This release is therefore  largely
   untested and the port will be unmaintained in the long term.

   In the technical sense, WebDAV (and the "web folders technology", the term
   coined to  describe its  Windows-powered client  side) is  an extension to
   HTTP to  provide more efficient   means  of exchanging documents in   both
   directions.   As a WebDAV client, Cadaver  was designed to resemble an FTP
   client as much as possible.


2. Installation

   EMX v 0.9d or later  is required, all  dependent DLLs are shipped with the
   package.

   To test your installation,  run CADAVER.EXE and  "open" any WebDAV URL you
   know  of.  If you pass the  authentication procedure, chances are 99% that
   everything will run smoothly after this point.

   A "dumb" version has been  compiled separately for  use with  stdin/stdout
   redirection  (i.e. automated scripting). In this version, readline support
   (the equivalent  of "KEYS ON" of CMD.EXE) has been  left out as it  is not
   compatible with redirection.


3. The "-p" option

   This undocumented option is used  to specify an HTTP proxy server. Using a
   (possibly Linux-based) router  with Privoxy  and Tor, you  can even access
   WebDAV-enabled web sites in the ".onion" domain, e.g.:

   cadaver http://domainnamestring.onion/ -p 192.168.99.55:8118


4. Development Notes

   If you need a really straightforward  out-of-the-box build, go  for 0.22.4
   or try  the  Innotek/Netlabs  GCC instead of  GCC. There are  arcane  libc
   dependencies that could break some features such as wildcard expansion. In
   this case you can tweak the root  Makefile manually to include  some extra
   modules:

	lib/glob.o lib/regex.o lib/getlogin_r.o lib/mempcpy.o lib/fnmatch.o lib/getpass.o lib/strncasecmp.o lib/lstat.o lib/tempname.o lib/mkstemp.o \

   The original toolchain:
   * EMX v 0.9d
   * GCC v 3.2.1
   * Autoconf v 2.59-20051231 (CVS)
   * bash v 2.05
   * GNU make v 3.81 beta3
   * The "standard" set of GNU *utils from the EMX age.

   The "Configure" script was invoked with:
   --with-ssl [--disable-readline]


5. If you intend to use WebDAV to "create, share and explore"... 

   ...instead  of occasional/scripted  file transfers, then there  is a  more
   natural choice: a plugin for NetDrive. See http://ndpdav.netlabs.org


6. Revision History

   23/08/2005: Initial port of Cadaver v 0.22.2
   03/09/2005: Re-release of 0.22.2 with -lreadline and a binary mode patch
   07/02/2006: Updated to 0.22.3 + patches; readline left out again
   27/01/2008: Updated to 0.23.0 due to popular demand for fresh Cadavers


7. Contact

   Andrew Belov <andrew_belov@newmail.ru> 

   The original source code is available at http://www.webdav.org/cadaver
