gnut -- Un*x/Win32 Gnutella Client
==================================
http://www.mrob.com/gnut  (and old site: http://www.umr.edu/~jjp )

If you're new to gnut and/or gnutella in general:

   I highly recommend you read the file TUTORIAL, an excellent
   introduction to gnut written by Elijah <eli@panix.com> 

If you have not run a version of gnut before on your current machine
or account:

   Before you can run gnut you need a hosts list file. Try going to
   gnutella.wego.com, gnutella.co.uk/servers, or gnutelliums.com and
   look in the "downloads" or "files" area for a GNUTELLA.txt or
   GNUTELLA.net file. Save this file as ~/.gnut_hosts

   If you can't find the file, you can also connect to one of the
   "host cache" or "hosts server" addresses like
   gnutellahosts.com:6346, router.limewire.com:6346 or
   gnet1.ath.cx:6346 by typing a command like
   "open gnet1.ath.cx:6346", then after the connection is open
   (use "info" to find out), type "update" to send a request (called
   a "ping") for host addresses. After you do this, use "info" again
   to make sure the "HOST STATS" have a number bigger than 0. As
   soon as you quit gnut, it will save the host list as
   ~/.gnut_hosts and you're all set.

Compiling:

   NOTE: gnut has been tested successfully on Linux 2.2.14, SunOS
   5.5-5.7, FreeBSD 2.8, 3.4, 4.0-RELEASE, and Win32. Some OS versions
   have not been tested recently, so if you have problems you can
   always consider trying an older version of gnut.

   In order to compile under Win32, use the supplied wgnut.dsw file.


   The INSTALL document describes how to build gnut. If you are running
   a fairly recent (less than a year old) release of Linux, it will amount
   to the following steps:

   # untar the tarfile, which creates a directory "gnut-0.X.XX"
   # go into the directory that was just produced
   ./configure  # or 'sh ./configure' if in csh on SysV
   make

   If you don't already have a .gnut_hosts file, get one as described above.

   src/gnut     # to test the executable to see if it works
   make install # if you want to put it in a public directory like
                # /usr/local/bin


Usage:

   Type 'gnut --help' to see command-line options. Type 'gnut' with
   no arguments to run the program. At the gnut command prompt, type
   'help' for a list of commands. Type 'help commandname' (example
   'help find' or 'help load' for a more complete description of
   one command.

Bugs:

   Report bugs to "mrob at mrob dot com"

Documentation:

   All documentation can now be perused at your leisure in the Gnut
   Manual at:

      http://www.mrob.com/gnut

   or at gnut's old home:

      http://www.umr.edu/~jjp

Copying:

   This file, and everything contained in this package is distributed
   under the terms of the GNU General Public License, the terms of
   which can be found in the file COPYING.



Wow! You made it through reading all of that crap up above. If you
have any questions/comments/suggestions/patches/ideas, please send
them to Robert "mrob at mrob dot com", or contact Josh at "josh at
nemonet dot com" (but he has effectively discontinued maintaining
gnut)

Thanks!

- Robert Munafo, 10 Nov 2000
