Mercurial > hg > index.fcgi > gift-gnutella > gift-gnutella-0.0.11-1pba

comparison README @ 0:d39e1d0d75b6

find changesets by author, revision, files, or words in the commit message
initial add
author paulo@hit-nxdomain.opendns.com
date Sat, 20 Feb 2010 21:18:28 -0800
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:962147a136ce
1 $Id: README,v 1.13 2004/02/06 02:49:09 hipnod Exp $
2
3 Compilation & Installation
4 --------------------------
5
6 You must install giFT before installing this plugin.
7
8 The configure script uses pkg-config to search for giFT. If you have
9 installed giFT somewhere besides the default pkg-config lookup path, you
10 need to change the PKG_CONFIG_PATH environment variable so configure can
11 find libgift.pc.
12
13 After installing, you should run the gift-setup script. If you want, you can
14 setup the plugin manually by adding "Gnutella" to the /main/plugins line in
15 ~/.giFT/giftd.conf, like so:
16
17 [main]
18 plugins = OpenFT:Gnutella
19
20 You may also use a fully qualified path to the plugin filename:
21
22 [main]
23 plugins = OpenFT:/usr/local/lib/giFT/libGnutella.la
24
25 You can also specify the plugin on the command line:
26
27 $ giftd -d -p Gnutella -p OpenFT
28
29
30 Bootstrapping
31 -------------
32
33 On initial startup, the plugin has to find some Gnutella nodes to connect to.
34 No default nodes are hardcoded. Instead, there is a list of websites called
35 "GWebCaches", and a GWebCache is randomly selected and contacted to retrieve a
36 list of currently active nodes. If these nodes are busy, they can still
37 bootstrap the plugin by informing it of more nodes to connect to, so this
38 process continues until the plugin finds some available nodes.
39
40 This process tends to be somewhat fragile, because a GWebCache is usually only
41 contacted once for this purpose, so the GWebCache handling code in the plugin
42 runs infrequently and tends to have bugs. If you experience problems
43 connecting, it would help to view the log file when reporting problems.
44
45 If you're interested in running a GWebCache, see "More GWebCache Info" below
46 for more information.
47
48
49 Configuration
50 -------------
51
52 The configuration file is in $HOME/.giFT/Gnutella/Gnutella.conf, and is created
53 if it doesn't exist. The syntax of the config file is the same as other giFT
54 files.
55
56 gift-setup will set the default port to something random. You can change it by
57 editing the plugin's config file. If this port isn't reachable, you will
58 receive less search results because you cannot download from firewalled users.
59 You may have to do some other configuration (forward the port on your firewall,
60 etc) to make the port reachable.
61
62
63
64 More GWebCache info
65 -------------------
66
67 If you're interested in running a GWebCache, more information can be found at
68 http://www.gnucleus.com/gwebcache/. Note that while running one doesn't
69 require a lot of bandwidth for each request, there are quite a lot of nodes
70 making many requests to a dwindling number of GWebCaches (there used to be
71 200+, not there are only about 60 left due to abusive nodes hammering them).
72
73 It helps to put the cache on a separate domain (for example, gwc.foo.com) so
74 that the name can be removed from the DNS if the load on it becomes too high.
75 Note that this name probably shouldn't contain the word "cache" in it, because
76 that may be treated specially by HTTP proxies.
77
78
79 Contact
80 -------
81
82 Email: hipnod@bellsouth.net [Original author]
83
84 IRC: #giFT-gnutella on irc.freenode.net
85