1 diff -urN BitTorrent-3.4.2.orig/debian/bittorrent-downloader.1 BitTorrent-3.4.2/debian/bittorrent-downloader.1
2 --- BitTorrent-3.4.2.orig/debian/bittorrent-downloader.1 1970-01-01 00:00:00.000000000 +0000
3 +++ BitTorrent-3.4.2/debian/bittorrent-downloader.1 2004-11-07 23:45:49.746092560 +0000
5 +.TH "BITTORRENT-DOWNLOADER" 1 "Sep 24 2003"
7 +bittorrent-downloader \- download files using a scatter-gather network
10 +.B btdownloadheadless [ option ... ] \fIURL\fB
11 +.B btdownloadheadless [ option ... ] \fIfilename\fB
12 +.B btdownloadcurses [ option ... ] \fIURL\fB
13 +.B btdownloadcurses [ option ... ] \fIfilename\fB
14 +.B btdownloadgui [ option ... ] \fIURL\fB
15 +.B btdownloadgui [ option ... ] \fIfilename\fB
20 +This manual page documents briefly the \fBbtdownloadheadless\fP,
21 +\fBbtdownloadcurses\fP, and \fBbtdownloadgui\fP commands.
22 +This manual page was written for the Debian distribution
23 +because the original program does not have a manual page.
25 +These are all programs that allow a user to download files using
26 +bittorrent, a peer to peer, scatter-gather network protocol.
27 +They all have the same options.
29 +These programs follow the usual GNU command line syntax, with long
30 +options starting with two dashes (`-').
31 +A summary of options is included below.
33 +.B \-\-responsefile \fIfilename\fP
34 +treat \fIfilename\fP as a file which the server reponse was stored in. If this
35 +option is used, no filename or URL should be present on the command line.
38 +retrieve the torrent info file from \fIurl\fP. If this option is used, no
39 +filename or URL should be present on the command line.
41 +.B \-i \fIip\fP | \-\-ip \fIip\fP
42 +report \fIip\fP as your IP to the tracker
45 +bind to \fIip\fP instead of the default
47 +.B \-\-minport \fIportnum\fP
48 +set \fIportnum\fP as the minimum port to listen on, counts up if unavailable (default 6881)
50 +.B \-\-maxport \fIportnum\fP
51 +set \fIportnum\fP as the maximum port to listen on (default 6889)
53 +.B \-\-saveas \fIfilename\fP
54 +store the downloaded file to \fIfilename\fP, instead of querying user (gui) or
55 +using the filename stored in the torrent info file
57 +.B \-\-max_uploads \fInum\fP
58 +Only allow \fInum\fP uploads at once (default 4)
60 +.B \-\-max_upload_rate \fIkbytes\fP
61 +maximum rate to upload at in kilobytes, 0 means no limit (default 0)
63 +.B \-\-keepalive_interval \fIsecs\fP
64 +pause \fIsecs\fP seconds between sending keepalives (default 120.0)
66 +.B \-\-download_slice_size \fIbytes\fP
67 +query for \fIbytes\fP bytes per request (default 32768)
69 +.B \-\-request_backlog \fInum\fP
70 +keep \fInum\fP requests in a single pipe at once (default 5)
72 +.B \-\-max_message_length \fIbytes\fP
73 +set \fIbytes\fP to the maximum length prefix encoding you'll accept over the wire - larger values get the connection dropped (default 8388608)
75 +.B \-\-timeout \fIsecs\fP
76 +wait \fIsecs\fP before closing sockets which nothing has been recieved on (default 300.0)
78 +.B \-\-timeout_check_interval \fIsecs\fP
79 +check whether connections have timed out every \fIsecs\fP seconds (default 60.0)
81 +.B \-\-max_slice_length \fIbytes\fP
82 +requests from peers larger than \fIbytes\fP bytes are ignored (default 131072)
84 +.B \-\-max_rate_recalculate_interval \fIsecs\fP
85 +connections that pause longer than \fIsecs\fP seconds are given reduced rate (default 15.0)
87 +.B \-\-max_rate_period \fIsecs\fP
88 +set \fIsecs\fP to the maximum amount of time to guess the current rate estimate represents (default 20.0)
90 +.B \-\-upload_rate_fudge \fIsecs\fP
91 +set the time equivalent of writing to kernel-level TCP buffer to \fIsecs\fP (default 5.0)
93 +.B \-\-display_interval \fIsecs\fP
94 +update displayed information every \fIsecs\fP seconds (default 0.1)
96 +.B \-\-rerequest_interval \fIsecs\fP
97 +request more peers every \fIsecs\fP seconds (default 300)
99 +.B \-\-min_peers \fInum\fP
100 +do not rerequest if we have \fInum\fP peers already (default 20)
102 +.B \-\-http_timeout \fIsecs\fP
103 +wait \fIsecs\fP seconds before assuming a http connection has timed out (default 60)
105 +.B \-\-snub_time \fIsecs\fP
106 +wait \fIsecs\fP seconds for data to come in over a connection before assuming it's semi-permanently choked (default 30.0)
108 +.B \-\-spew \fI 1 | 0 \fP
109 +whether to display diagnostic info to stdout. This option is not useful when
110 +using btdownloadcurses or btdownloadgui. (default 0)
111 +.B \-\-max_initiate \fInum\fP
112 +stop initiating new connections when we have \fInum\fP peers (default 40)
114 +.B \-\-check_hashes \fI 1 | 0 \fP
115 +whether to check hashes on disk (defaults to 1)
117 +.B \-\-report_hash_failures \fI 1 | 0 \fP
118 +whether to report to the user that hash failuers occur (non-fatal, common error) (default 0)
120 +.B \-\-rarest_first_priority_cutoff \fInum\fP
121 +the number of peers which need to have a piece before other partials take
122 +priority over rarest first (default 3)
126 +.BR btmakemetafile (1),
127 +.BR btlaunchmany (1).
129 +More information on the \fBBitTorrent\fR protocol used for distributing files is available
131 +.B http://bitconjurer.org/BitTorrent/protocol.html
133 +You will also find a full description on the advantages of the protocol in the academic paper
134 +.B "Incentives Build Robustness in BitTorrent"
136 +.B http://bitconjurer.org/BitTorrent/bittorrentecon.pdf
139 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
140 +for the Debian GNU/Linux system (but may be used by others).
141 diff -urN BitTorrent-3.4.2.orig/debian/bittorrent-multi-downloader.1 BitTorrent-3.4.2/debian/bittorrent-multi-downloader.1
142 --- BitTorrent-3.4.2.orig/debian/bittorrent-multi-downloader.1 1970-01-01 00:00:00.000000000 +0000
143 +++ BitTorrent-3.4.2/debian/bittorrent-multi-downloader.1 2004-11-07 23:45:49.746092560 +0000
145 +.TH "BITTORRENT-MULTI-DOWNLOADER" 1 "Jan 18 2003"
147 +bittorrent-multi-downloader \- multiple file clients for bittorrent
150 +.B btlaunchmany \fIdirname\fP [ option ... ]
151 +.B btlaunchmanycurses \fIdirname\fP [ option ... ]
154 +This manual page documents briefly the \fBbtlaunchmany\fP and
155 +\fBbtlaunchmanycurses\fP commands.
156 +This manual page was written for the Debian distribution
157 +because the original program does not have a manual page.
159 +\fBbtlaunchmany\fP is a program that eases the use of
160 +bittorrent in multiple-downloader situations. The program checks
161 +a directory for torrent files. When it finds any, it starts a
162 +separate downloader thread for each file.
165 +These programs have the exact same options as the normal
166 +downloaders, which are documented in \fBbittorrent-downloader\fP(1).
169 +.BR bittorrent-downloader (1),
170 +.BR btmakemetafile (1),
174 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
175 +for the Debian GNU/Linux system (but may be used by others).
176 diff -urN BitTorrent-3.4.2.orig/debian/btdownloadcurses.1 BitTorrent-3.4.2/debian/btdownloadcurses.1
177 --- BitTorrent-3.4.2.orig/debian/btdownloadcurses.1 1970-01-01 00:00:00.000000000 +0000
178 +++ BitTorrent-3.4.2/debian/btdownloadcurses.1 2004-11-07 23:46:40.901315784 +0000
180 +.so bittorrent-downloader.1
182 diff -urN BitTorrent-3.4.2.orig/debian/btdownloadgui.1 BitTorrent-3.4.2/debian/btdownloadgui.1
183 --- BitTorrent-3.4.2.orig/debian/btdownloadgui.1 1970-01-01 00:00:00.000000000 +0000
184 +++ BitTorrent-3.4.2/debian/btdownloadgui.1 2004-11-07 23:45:49.754091344 +0000
186 +.so bittorrent-downloader.1
187 diff -urN BitTorrent-3.4.2.orig/debian/btdownloadheadless.1 BitTorrent-3.4.2/debian/btdownloadheadless.1
188 --- BitTorrent-3.4.2.orig/debian/btdownloadheadless.1 1970-01-01 00:00:00.000000000 +0000
189 +++ BitTorrent-3.4.2/debian/btdownloadheadless.1 2004-11-07 23:45:49.755091192 +0000
191 +.so bittorrent-downloader.1
192 diff -urN BitTorrent-3.4.2.orig/debian/btlaunchmany.1 BitTorrent-3.4.2/debian/btlaunchmany.1
193 --- BitTorrent-3.4.2.orig/debian/btlaunchmany.1 1970-01-01 00:00:00.000000000 +0000
194 +++ BitTorrent-3.4.2/debian/btlaunchmany.1 2004-11-07 23:45:49.755091192 +0000
196 +.so bittorrent-multi-downloader.1
197 diff -urN BitTorrent-3.4.2.orig/debian/btlaunchmanycurses.1 BitTorrent-3.4.2/debian/btlaunchmanycurses.1
198 --- BitTorrent-3.4.2.orig/debian/btlaunchmanycurses.1 1970-01-01 00:00:00.000000000 +0000
199 +++ BitTorrent-3.4.2/debian/btlaunchmanycurses.1 2004-11-07 23:45:49.755091192 +0000
201 +.so bittorrent-multi-downloader.1
203 diff -urN BitTorrent-3.4.2.orig/debian/btmakemetafile.1 BitTorrent-3.4.2/debian/btmakemetafile.1
204 --- BitTorrent-3.4.2.orig/debian/btmakemetafile.1 1970-01-01 00:00:00.000000000 +0000
205 +++ BitTorrent-3.4.2/debian/btmakemetafile.1 2004-11-07 23:45:49.756091040 +0000
207 +.\" Hey, EMACS: -*- nroff -*-
208 +.\" First parameter, NAME, should be all caps
209 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
210 +.\" other parameters are allowed: see man(7), man(1)
211 +.TH "BTMAKEMETAFILE" 1 "Jan 18 2003"
212 +.\" Please adjust this date whenever revising the manpage.
214 +.\" Some roff macros, for reference:
215 +.\" .nh disable hyphenation
216 +.\" .hy enable hyphenation
217 +.\" .ad l left justify
218 +.\" .ad b justify to both left and right margins
219 +.\" .nf disable filling
220 +.\" .fi enable filling
221 +.\" .br insert line break
222 +.\" .sp <n> insert n+1 empty lines
223 +.\" for manpage-specific macros, see man(7)
225 +btmakemetafile \- program to generate torrent info files for bittorrent
227 +.B btmakemetafile \fIfile\fP \fItracker_announce_address\fP [ option ... ]
229 +This manual page documents briefly the \fBbtmakemetafile\fP
231 +This manual page was written for the Debian distribution
232 +because the original program does not have a manual page.
234 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
235 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
237 +\fBbtmakemetafile\fP is a program that generates the torrent info files
238 +which are distributed to bittorrent clients (usually via the WWW) in order
239 +to inform them where the designated tracker for the torrent is located, and
240 +to allow them to verify the file's contents.
242 +\fBbtmakemetafile\fP takes two arguments. Both are required. The first
243 +is the file that the torrent info file will be generated for. The second is
244 +the "announce" address of a tracker (ex. http://127.0.0.1:6969/announce).
247 +.B \-\-piece_size_pow2 \fIarg\fP
248 +which power of 2 to set the piece size to (default: 18)
251 +.BR bittorrent-downloader (1),
253 +.BR btreannounce (1),
257 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
258 +for the Debian GNU/Linux system (but may be used by others).
259 diff -urN BitTorrent-3.4.2.orig/debian/btreannounce.1 BitTorrent-3.4.2/debian/btreannounce.1
260 --- BitTorrent-3.4.2.orig/debian/btreannounce.1 1970-01-01 00:00:00.000000000 +0000
261 +++ BitTorrent-3.4.2/debian/btreannounce.1 2004-11-07 23:45:49.756091040 +0000
263 +.\" Hey, EMACS: -*- nroff -*-
264 +.\" First parameter, NAME, should be all caps
265 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
266 +.\" other parameters are allowed: see man(7), man(1)
267 +.TH "BTREANNOUNCE" 1 "Jan 18 2003"
268 +.\" Please adjust this date whenever revising the manpage.
270 +.\" Some roff macros, for reference:
271 +.\" .nh disable hyphenation
272 +.\" .hy enable hyphenation
273 +.\" .ad l left justify
274 +.\" .ad b justify to both left and right margins
275 +.\" .nf disable filling
276 +.\" .fi enable filling
277 +.\" .br insert line break
278 +.\" .sp <n> insert n+1 empty lines
279 +.\" for manpage-specific macros, see man(7)
281 +btreannounce \- change the announce address of a torrent file.
283 +\fBbtreannounce\fP \fIurl\fP \fItorrent\fP [ \fItorrent\fP ... ]
285 +This manual page documents briefly the \fBbtreannounce\fP
287 +This manual page was written for the Debian distribution
288 +because the original program does not have a manual page.
290 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
291 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
293 +\fBbtreannounce\fP is a program which will change the announce
294 +address of one or more existing torrent files.
295 +The torrent files will be modified to use the new
296 +announce url given by the \fIurl\fP argument.
299 +.BR bittorrent-downloader (1),
300 +.BR btmakemetafile (1),
304 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
305 +for the Debian GNU/Linux system (but may be used by others).
306 diff -urN BitTorrent-3.4.2.orig/debian/btrename.1 BitTorrent-3.4.2/debian/btrename.1
307 --- BitTorrent-3.4.2.orig/debian/btrename.1 1970-01-01 00:00:00.000000000 +0000
308 +++ BitTorrent-3.4.2/debian/btrename.1 2004-11-07 23:45:49.757090888 +0000
310 +.\" Hey, EMACS: -*- nroff -*-
311 +.\" First parameter, NAME, should be all caps
312 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
313 +.\" other parameters are allowed: see man(7), man(1)
314 +.TH "BTRENAME" 1 "Jan 18 2003"
315 +.\" Please adjust this date whenever revising the manpage.
317 +.\" Some roff macros, for reference:
318 +.\" .nh disable hyphenation
319 +.\" .hy enable hyphenation
320 +.\" .ad l left justify
321 +.\" .ad b justify to both left and right margins
322 +.\" .nf disable filling
323 +.\" .fi enable filling
324 +.\" .br insert line break
325 +.\" .sp <n> insert n+1 empty lines
326 +.\" for manpage-specific macros, see man(7)
328 +btrename \- change the suggested filename inside a bittorrent file
330 +\fBbttrack\fP \fItorrent\fP \fInewfilename\fP
332 +This manual page documents briefly the \fBbtrename\fP
334 +This manual page was written for the Debian distribution
335 +because the original program does not have a manual page.
337 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
338 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
340 +\fBbtrename\fP is a program which will change the suggested
341 +filename presented to the user for a bittorrent file. This
342 +will make the downloader save it as a different name by default.
343 +The torrent specified by the \fItorrent\fP option is modified
344 +in-place, changing the suggested filename to \fInewfilename\fP.
347 +.BR bittorrent-downloader (1),
348 +.BR btmakemetafile (1),
349 +.BR btreannounce (1).
352 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
353 +for the Debian GNU/Linux system (but may be used by others).
354 diff -urN BitTorrent-3.4.2.orig/debian/btshowmetainfo.1 BitTorrent-3.4.2/debian/btshowmetainfo.1
355 --- BitTorrent-3.4.2.orig/debian/btshowmetainfo.1 1970-01-01 00:00:00.000000000 +0000
356 +++ BitTorrent-3.4.2/debian/btshowmetainfo.1 2004-11-07 23:45:49.757090888 +0000
358 +.\" Hey, EMACS: -*- nroff -*-
359 +.\" First parameter, NAME, should be all caps
360 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
361 +.\" other parameters are allowed: see man(7), man(1)
362 +.TH "BTSHOWMETAINFO" 1 "Jan 18 2003"
363 +.\" Please adjust this date whenever revising the manpage.
365 +.\" Some roff macros, for reference:
366 +.\" .nh disable hyphenation
367 +.\" .hy enable hyphenation
368 +.\" .ad l left justify
369 +.\" .ad b justify to both left and right margins
370 +.\" .nf disable filling
371 +.\" .fi enable filling
372 +.\" .br insert line break
373 +.\" .sp <n> insert n+1 empty lines
374 +.\" for manpage-specific macros, see man(7)
376 +btshowmetainfo \- display information in bittorrent files
378 +\fBbtshowmetainfo\fP \fIfile\fP [ file ... ]
380 +This manual page documents briefly the \fBbtshowmetainfo\fP
382 +This manual page was written for the Debian distribution
383 +because the original program does not have a manual page.
385 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
386 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
388 +\fBbtshowmetainfo\fP is a program which will display the information
389 +stored in a bittorrent file.
392 +.BR bittorrent-downloader (1),
393 +.BR btmakemetafile (1).
396 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
397 +for the Debian GNU/Linux system (but may be used by others).
398 diff -urN BitTorrent-3.4.2.orig/debian/bttrack.1 BitTorrent-3.4.2/debian/bttrack.1
399 --- BitTorrent-3.4.2.orig/debian/bttrack.1 1970-01-01 00:00:00.000000000 +0000
400 +++ BitTorrent-3.4.2/debian/bttrack.1 2004-11-07 23:45:49.758090736 +0000
402 +.\" Hey, EMACS: -*- nroff -*-
403 +.\" First parameter, NAME, should be all caps
404 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
405 +.\" other parameters are allowed: see man(7), man(1)
406 +.TH "BTTRACK" 1 "Jan 18 2003"
407 +.\" Please adjust this date whenever revising the manpage.
409 +.\" Some roff macros, for reference:
410 +.\" .nh disable hyphenation
411 +.\" .hy enable hyphenation
412 +.\" .ad l left justify
413 +.\" .ad b justify to both left and right margins
414 +.\" .nf disable filling
415 +.\" .fi enable filling
416 +.\" .br insert line break
417 +.\" .sp <n> insert n+1 empty lines
418 +.\" for manpage-specific macros, see man(7)
420 +bttrack \- tracker for bittorrent
422 +.B bttrack \fI [ option ... ]
424 +This manual page documents briefly the \fIbttrack\fP
426 +This manual page was written for the Debian distribution
427 +because the original program does not have a manual page.
429 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
430 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
432 +\fBbttrack\fP is a program that serves as a "tracker" for
433 +bittorrent clients. This program keeps track of the completion
434 +of each client, and communcates that information when requested
437 +These programs follow the usual GNU command line syntax, with long
438 +options starting with two dashes (`-').
439 +A summary of options is included below.
441 +.B \-\-port \fIportnum\fP
442 +listen on port \fIportnum\fP (default 80)
444 +.B \-\-dfile \fIfilename\fP
445 +store recent downloader info in \fIfilename\fP
447 +.B \-\-bind \fIip\fP
448 +bind to \fIip\fP instead of the default
450 +.B \-\-socket_timeout \fIsecs\fP
451 +timeout for closing connections (default 15)
453 +.B \-\-save_dfile_interval \fIsecs\fP
454 +seconds between saving dfile (default 300)
456 +.B \-\-timeout_downloaders_interval \fIsecs\fP
457 +seconds between expiring downloaders (default 2700)
459 +.B \-\-reannounce_interval \fIsecs\fP
460 +seconds downloaders should wait between reannouncements (default 1800)
462 +.B \-\-response_size \fInum\fP
463 +number of peers to send in an info message (default 50)
465 +.B \-\-timeout_check_interval \fIsecs\fP
466 +time to wait between checking if any connections have timed out (default 5)
468 +.B \-\-nat_check \fI[ 1 | 0 ]\fP
469 +whether to check back and ban downloaders behind NAT (default 1)
471 +.B \-\-min_time_between_log_flushes \fIsecs\fP
472 +minimum time it must have been since the last flush to do another one (default 3.0)
474 +.B \-\-allowed_dir \fIpath\fP
475 +only allow downloads for .torrents in this directory (default '')
477 +.B \-\-parse_allowed_interval \fImins\fP
478 +minutes between reloading of allowed_dir (default 15)
480 +.B \-\-show_names \fI[ 1 | 0 ]\fP
481 +whether to display names from alowed dir (default 1)
484 +.BR bittorrent-downloader (1),
485 +.BR btmakemetafile (1).
488 +This manual page was written by Michael Janssen <jamuraa@debian.org>,
489 +for the Debian GNU/Linux system (but may be used by others).