_____________________________________________________________________________

                               N e t F e t c h

                             Simple HTTP Fetcher

                          by David Thomas,  1996-8
                         version 1.30 (24 May 1998)
_____________________________________________________________________________


 Introduction ______________________________________________________________
 
It's often a lot quicker and easier to have a small command-line utility to
fetch things from web sites, rather than having to fire up a bloated and
unstable web browser to do the same task. ;-)

NetFetch is a simple, portable, command line utility to fetch objects from
web servers.  It makes no attempt to fetch pages recursively - it cannot
'mirror' web sites - it just saves a single URL to a file.

Source code is provided.  It has been compiled and tested under RISC OS (with
Acorn C/C++ and SocketLib) and under Sun OS and Solaris (with GCC).


 Usage _____________________________________________________________________

  Syntax: netfetch [-proxy <http://proxy.server:port>]
                   [-list <text file list of "url<space>filename" pairs>]
                   [<url> <filename>]

Simple fetch:
  *netfetch http://www.tristone.co.uk/index.html index/html


Fetching through a proxy:
  *netfetch -proxy http://proxy.isp.co.uk:8080 http://www.tristone.co.uk/index.html index/html


Fetching a text file list of URLs:
  *netfetch -list URLFile

  ... where the file 'URLFile' is like:
   "http://www.tristone.co.uk/index.html index/html
    http://www.tristone.co.uk/image.gif image/gif"


Fetching a text file list of URLs, through a proxy:
  *netfetch -proxy http://proxy.isp.co.uk:8080 -list URLs


 Notes _____________________________________________________________________

 - If you're able to compile the code, then you have further options
   controlled by #defines.  The first option 'BLOCKING' makes NetFetch use
   the "TaskWindow sleep" feature of Internet 5 and FreeNet 2 stacks,
   allowing NetFetch to sleep whilst waiting for data and not consume any
   processor time.  This gives much smoother fetches.


 Versions __________________________________________________________________

1.30 (24 May 1998)
 - The memcpy() call had its parameters the wrong way around!  Bizarrely this
   worked, but only if you gave Headlines a large wimpslot.
 - Headlines should need only a 36K wimpslot.

1.29 (20 Apr 1998)
 - Revised headers so that servers that expect the 'Host' header (such as
   www.argonet.co.uk) will now work. (Report from A. Piper)
 - The 'MOZILLA' compile-time option has been removed.

1.28 (20 Mar 1998)
 - Percentage display. (Suggested by S. Winter)

1.27
 - Proxy bug fix.

1.25
 - Run-time list handling.  Proxying.

1.04 (14 Oct 1997)
 - First release.


 Copyright & Contact Addresses _____________________________________________

This software is copyrighted work of David Thomas, it is supplied as is;
using it is entirely at your own risk.  I make no warranty as to the fitness
of this software for any purpose.  You are free to distribute this program
toanyone you please, as long as you are not supplying it for personal or
commercial gain and it is delivered with all of the supplied files unaltered.

If you have any comments, bug reports, suggestions for future versions or
anything else dont hesitate to contact me at -

  Mail:  Mr D.P. Thomas
         20 Rosebery Avenue
         Waterloo
         Liverpool
         L22 2BH

  Email: dpt@tristone.co.uk

  WWW:   http://www.tristone.co.uk/davespace/
_____________________________________________________________________________

