HTTP Fetcher
Lyle Hanson (lhanson@cs.nmu.edu) (C) 2001
http://cs.nmu.edu/~lhanson/http_fetcher/
===============================================================================


ABOUT
=====
HTTP Fetcher is a small library that downloads files via HTTP.  I developed
it for use within another project, and because I didn't find any pre-existing
software that did exactly what I wanted without hassle.  Hopefully you'll find
it useful and avoid writing similar code yourself.

It supports the GET method.  Anything further would involve more than
fetching, now wouldn't it?  If you need more than GET, there are other
libaries out ther that would be better suited to your needs (try http-tiny,
find it at freshmeat.net).

HTTP Fetcher is meant to be small, fast, and flexible at what it does.
It's very robust, in my opinion.  It's easy to use;  using one function,
it can download any kind of file via HTTP.  It also offers further
sophistication, allowing you control over what (if any) User-Agent or
Referrer you wish to show to the web server.  Which is neat stuff, depending
on your use (testing and stealth/deception are two that come to mind).


DEPENDENCIES
============
HTTP Fetcher should run on most unices that support BSD-type sockets and have
a network connection.  Developed and tested on x86 machines running recent
versions of RedHat.


INSTALLATION
============
Read the INSTALL file for info on building and installing the library


USAGE
=====
Read the manpages in the docs directory, see the 'testfetch' example included,
check out 'fetch' (http://cs.nmu.edu/~lhanson/fetch/), a complete HTTP file download utility.


LICENCE
=======
HTTP Fetcher is licenced under the GNU Lesser General Public License (LGPL)
version 2 or newer.  See the LICENSE file for full info.  Feel free to contact
me if you have any questions/concerns over licensing issues.


FEEDBACK
========
If you use this library for anything, drop me a line (lhanson@cs.nmu.edu).
I'd love to know that formally releasing this stuff was worth it.  I'm open
to any input (bad or good).


TODO:
====
Create RPM packages, deb packages, add to FreeBSD "ports".
Volunteers welcome!!


BUGS:
=====
No known bugs.  Don't hesitate to send me any bug reports or patches.
