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