1GTK-GNUTELLA(1) 0.96.9 GTK-GNUTELLA(1)
2
3
4
6 gtk-gnutella - A Gnutella client for Gtk+
7
9 gtk-gnutella
10
12 gtk-gnutella is a GTK+ Gnutella client for Unix. It supports both
13 searching and sharing with the 0.6 version of the Gnutella protocol and
14 includes support for numerous protocol improvements and additions that
15 have been added to the Gnutella network since.
16
17 The Gnutella network allows users to search for files and to advertise
18 files shared locally, but is not handling file transfers which is done
19 through HTTP. The addition of Gnutella-specific HTTP headers makes
20 each Gnutella client a powerful file swarmer where even firewalled
21 hosts can contribute.
22
23 Great care has been devoted into making gtk-gnutella powerful, effi‐
24 cient and reliable.
25
27 --compile-info
28 Tell gtk-gnutella to output a list of variables describing com‐
29 pile-time configuration information that was gathered when the
30 program was built.
31
32 --daemonize
33 This options causes gtk-gnutella to become a daemon. It detaches
34 from the terminal (if started from one) and forks itself into
35 the background. It also changes it working directory to the root
36 directory i.e., "/" so that it doesn't block a mount point for
37 example. This is mainly meant for headless mode but you can also
38 use it if the Gtk+ GUI is enabled.
39
40 For example, if you do not start gtk-gnutella from a terminal
41 but from a window manager menu, there's little reason to not
42 daemonize gtk-gnutella. Thus you might want to add the --daemo‐
43 nize option in this case.
44
45 Please note that when gtk-gnutella is started as a daemon all
46 output which is normally send to the standard output and stan‐
47 dard error output (usually your terminal or a common log file
48 such as ~/.xsession-errors), is sent to /dev/null. The options
49 --log-stderr and --log-stdout can be used to redirect log output
50 in this case.
51
52 --exec-on-crash path
53 Execute command specified in path when gtk-gnutella crashes.
54
55 --geometry
56 This option can be used to force the main window of the GUI to a
57 certain location on your screen and/or give it certain dimen‐
58 sions.
59
60 For example, the following would position the window in the
61 lower right corner with a width of 800 pixels and a height of
62 600 pixels:
63
64 gtk-gnutella --geometry 800x600-0-0
65
66 Note that none of this can be guaranteed, your window manager
67 has the last word on this. This option is a traditional command-
68 line switch supported by most X11 applications.
69
70 --help Show a summary of all supported options.
71
72 --log-stderr , --log-stdout
73 These options allow you to log everything which is written to
74 stderr respectively stdout to some files. A typical use would
75 look like this:
76
77 gtk-gnutella --daemonize \
78 --log-stderr ~/logs/gtkg.stderr \
79 --log-stdout ~/logs/gtkg.stdout
80
81 Redirecting these log messages also works without --daemonize.
82 Of course, log files can become large and you might want to ar‐
83 chive them or delete them periodically. After moving or deleting
84 the log files, you can send gtk-gnutella a SIGHUP signal to cre‐
85 ate new log files.
86
87 --no-xshm
88 Disable MIT shared memory extension, when running with the X
89 graphical user-interface.
90
91 --pause-on-crash
92 Pause the process on crash, so that a debugger may be attached
93 to inspect the current state for instance.
94
95 --ping This option allows you to check whether gtk-gnutella is cur‐
96 rently running. This option returns with a success code when
97 gtk-gnutella is already running, and with a failure code when it
98 is not.
99
100 This allows you to use the following code to start gtk-gnutella
101 from a cron job or window manager menu and avoid starting it
102 twice:
103
104 gtk-gnutella --ping || gtk-gnutella
105
106 --shell
107 When this option is used to connect to an already running
108 gtk-gnutella process over a local unix domain socket. This
109 socket is located at "$GTK_GNUTELLA_DIR/ipc/socket", thus nor‐
110 mally "~/.gtk-gnutella/ipc/socket". The socket is only accessi‐
111 ble by the user running gtk-gnutella which is enforced by
112 filesystem permissions. The socket is in a dedicated directory
113 because apparently not all systems honor the access permissions
114 on sockets as seen through the filesystem.
115
116 You can disable this feature by setting the property
117 "enable_local_socket" to FALSE. It is recommendable to use this
118 local socket whenever possible instead of the TCP socket to
119 access the shell interface remotely. The reason is that the
120 authentication token is passed non-encrypted over the network
121 and everyone who can sniff the network is able to connect to the
122 remote shell. This may not matter over the loopback interface or
123 a LAN, but it's a bad idea to use this over the Internet.
124
125 --version
126 Show the user-agent string used on the Gnutella network which
127 also holds the version information.
128
129 --topless
130 Starts gtk-gnutella without the graphical user-interface.
131
133 When gtk-gnutella is first started, it will attempt to connect to a
134 well-known hosts server for some hosts to connect to. If you know a
135 host you want to connect to, you can enter it in the box on the Gnutel‐
136 laNet tab and push the Add button. When first connecting to the
137 gnutella network, it can take some time to establish a stable connec‐
138 tion. Be patient.
139
141 To search files just type your query in the search box at the top of
142 the screen. All searches, both active and inactive, are shown in the
143 sidebar.
144
145 You can have multiple searches running at once. To start another search
146 while the first one is running, simply enter another search term into
147 the edit box at the top of the window.
148
149 To stop a particular search and remove its tab from the search window,
150 select the search by clicking on its tab and click the "Close search"
151 button. If you want to clear the list for a particular search, but want
152 to continue to see new files that are received for this search, click
153 the "Clear results" button.
154
155 It is possible to apply filtering to search results using the filter
156 editor. Click on "Edit filters" to access the editor. Use of the fil‐
157 tering editor goes beyond the scope of this man page, but there is a
158 tutorial on this topic on the gtk-gnutella homepage.
159
160 When you find a file that you want to download, select the file in the
161 list and click "Download selected". This file will be placed in the
162 download queue. On the downloads view you can watch the download
163 progress of the file(s) you are downloading.
164
165 It is also possible to select a bunch of files for downloading at once.
166 By holding down the control or shift keys while clicking files, you can
167 select several files and then click "Download selected" to put them all
168 in the download queue at once.
169
171 Most of the configuration can be done via the "Preferences" window that
172 can be accesed using the "File -> Preferences" menu-option. You will
173 find several tabs there, each tab regrouping common information. But
174 some specific information pertaining to downloads or searches are
175 directly available on the "Downloads" and "Uploads" panes.
176
177 If you linger your mouse over each configuration parameter, a tooltip
178 window will popup explaining the meaning of that parameter. You may
179 have to press "Enter" after a text input, or move the focus to another
180 parameter to validate your entry. Items configured via spin buttons
181 normally take effect immediately, unless you type text instead of using
182 the spin buttons.
183
185 $GTK_GNUTELLA_DIR/config_gnet
186 Per-user configuration file, for core settings. This can be
187 edited when the program is not running, but it is best to use
188 the GUI to change configuration variables. gtk-gnutella saves
189 this file every time the program is exited normally.
190
191 $GTK_GNUTELLA_DIR/config_gui
192 GUI configuration. It is best to not edit this file.
193
194 $GTK_GNUTELLA_DIR/dmesh
195 This is where the download mesh is persisted. You don't need to
196 worry about this.
197
198 $GTK_GNUTELLA_DIR/dmesh_ban
199 This is where temporarily banned download mesh entries are
200 stored.
201
202 $GTK_GNUTELLA_DIR/done.namesize
203 This file holds the name and size of files completely downloaded
204 by gtk-gnutella and which will now be ignored.
205
206 $GTK_GNUTELLA_DIR/done.sha1
207 This file holds the SHA1 of files completely downloaded by
208 gtk-gnutella and which will now be ignored.
209
210 $GTK_GNUTELLA_DIR/downloads
211 This is where the download queue is persisted. Only the direct
212 downloads (i.e. non-pushed) can be saved, since they don't need
213 routing information.
214
215 $GTK_GNUTELLA_DIR/hosts
216 This is the host cache. This is saved by gtk-gnutella on exit
217 and should not be edited by hand.
218
219 $GTK_GNUTELLA_DIR/searches.xml
220 This is where the open searches and all the search filters are
221 saved.
222
223 $GTK_GNUTELLA_DIR/sha1_cache
224 This is where the cache of all the computed SHA1 is stored.
225
226 $GTK_GNUTELLA_DIR/tth_cache
227 This is the directory under which all the computed TTH trees are
228 stored. These files are binary data.
229
230 $GTK_GNUTELLA_DIR/upload_stats
231 This file keeps track of the upload statistics.
232
234 gtk-gnutella searches GTK_GNUTELLA_DIR for configuration files. If this
235 variable is not set, HOME is used instead. If HOME is not set, then no
236 configuration information will be saved when gtk-gnutella exits.
237
239 There are a couple of mailing lists for gtk-gnutella. See
240 http://sourceforge.net/mail/?group_id=4467 for more info.
241
243 gtk-gnutella is production-quality software, but still has minor bugs
244 and incomplete or missing features. But which software doesn't for its
245 authors?
246
247 There are probably other missing features that should be listed here.
248
249 A list of known bugs might be available at the gtk-gnutella web site
250 (see below.)
251
253 Additional information about gtk-gnutella and the latest version are
254 available at http://gtk-gnutella.sourceforge.net/
255
256 Additional information about gnutella is available at
257 http://www.the-gdf.org/ http://www.infoanarchy.org/en/Gnutella
258 http://rfc-gnutella.sourceforge.net/
259
261 Yann Grossel wrote the original gtk-gnutella .
262
263 Raphael Manfredi <Raphael_Manfredi@pobox.com> is the current maintainer
264 and project leader (since version 0.14, released early September 2001).
265 For support, please contact the developer list, which can be reached at
266 <gtk-gnutella-devel@lists.sourceforge.net>.
267
268 For a full list of contributors, open the "About" menu.
269
270 Brian St. Pierre <bstpierre@bstpierre.org> wrote the initial version of
271 this manpage.
272
274 gtk-gnutella is Copyright (c) 2000, Yann Grossel, with additional copy‐
275 rights held by other contributors 2000-2009.
276
277 License to use and copy gtk-gnutella is given under the terms of the
278 GNU General Public License (GPL), version 2. Please see the file COPY‐
279 ING in the distribution for complete information.
280
281 Permission is granted to make and distribute verbatim copies of this
282 manual page provided the copyright notice and this permission notice
283 are preserved on all copies.
284
285 Permission is granted to copy and distribute modified versions of this
286 manual page under the conditions for verbatim copying, provided that
287 the entire resulting derived work is distributed under the terms of a
288 permission notice identical to this one.
289
290
291
292Version Mar 2011 GTK-GNUTELLA(1)