diff options
Diffstat (limited to 'src/libpcp_http/src/README')
-rw-r--r-- | src/libpcp_http/src/README | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/src/libpcp_http/src/README b/src/libpcp_http/src/README new file mode 100644 index 0000000..fa4cd6c --- /dev/null +++ b/src/libpcp_http/src/README @@ -0,0 +1,78 @@ +HTTP Fetcher +Lyle Hanson (lhanson@users.sourceforge.net) (C) 2001, 2003, 2004 +http://http-fetcher.sourceforge.net +=============================================================================== + + +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://fetch.sourceforge.net), 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@users.sourceforge.net). +I'd love to know that formally releasing this stuff was worth it. I'm open +to any input (bad or good). + + +TODO: +==== +Further development is focused on the 2.x series of http-fetcher. Only bugfixes +and minor improvements will be added to 1.x releases. + + +BUGS: +===== +This version introduces transparent redirects, but the 1.x series still does +not allow the client program access to the HTTP return code. So while you can +now follow redirects, your program won't know anything about it. You can, +however, turn off or configure the number of redirects to follow. + +A better interface is planned for 2.x.x. + + +CREDITS: +======== +Steve Augart (steve@augart.com) has been a huge contributor to the project. +Thanks, Steve! |