Mercurial > hg > index.fcgi > gift-gnutella > gift-gnutella-0.0.11-1pba
comparison README @ 0:d39e1d0d75b6
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 |