gnut -- Un*x/Win32 Gnutella Client ================================== http://www.mrob.com/gnut (which currently points to: http://www.gnutelliums.com/linux_unix/gnut/ ) 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 To build (and install) gnut: Read and follow the directions in the first few paragraphs of the file "DEPEND" (in the same directory as this file). More about building (compiling) below. If gnut does not connect to any hosts when you first start it up, even after a few minutes, try the following: Read the FAQ question 5.12 (in the manual chapter 5, file doc/gnut-5.html or on the Web, http://www.gnutelliums.com/linux_unix/gnut/doc/gnut-5.html) Get 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. Building (Compiling) and rebuilding: Building and installing is described in the file DEPEND, in the same directory as this file. If you are running any fairly recent and popular version of Unix or Linux, you'll have no trouble. Otherwise, read the INSTALL document for more about installation. Rebuilding after making changes is described in the HACKING file, found in the same directory as this file. Beware that some files cannot be changed directly; read HACKING for details. Usage: Type 'gnut --help' to see command-line options. They are explained fully in the manual chapter 4. 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 on the Internet. The permanent location is: http://www.mrob.com/gnut And it is currently being hosted by gnutelliums.com at: http://www.gnutelliums.com/linux_unix/gnut/doc/gnut.html 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, 27 Jun 2001