BitTorrent-man_pages.patch

   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
   4 @@ -0,0 +1,136 @@
   5 +.TH "BITTORRENT-DOWNLOADER" 1 "Sep 24 2003"
   6 +.SH NAME
   7 +bittorrent-downloader \- download files using a scatter-gather network
   8 +.SH SYNOPSIS
   9 +.nf
  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
  16 +.fi
  17 +.br
  18 +.B
  19 +.SH DESCRIPTION
  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.
  24 +.PP
  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.
  28 +.SH 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.
  32 +.TP
  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.
  36 +.TP
  37 +.B \-\-url \fIurl\fP
  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.
  40 +.TP
  41 +.B \-i \fIip\fP | \-\-ip \fIip\fP
  42 +report \fIip\fP as your IP to the tracker
  43 +.TP
  44 +.B \-\-bind \fIip\fP
  45 +bind to \fIip\fP instead of the default
  46 +.TP
  47 +.B \-\-minport \fIportnum\fP
  48 +set \fIportnum\fP as the minimum port to listen on, counts up if unavailable (default 6881)
  49 +.TP
  50 +.B \-\-maxport \fIportnum\fP
  51 +set \fIportnum\fP as the maximum port to listen on (default 6889)
  52 +.TP
  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
  56 +.TP
  57 +.B \-\-max_uploads \fInum\fP
  58 +Only allow \fInum\fP uploads at once (default 4)
  59 +.TP
  60 +.B \-\-max_upload_rate \fIkbytes\fP
  61 +maximum rate to upload at in kilobytes, 0 means no limit (default 0)
  62 +.TP
  63 +.B \-\-keepalive_interval \fIsecs\fP
  64 +pause \fIsecs\fP seconds between sending keepalives (default 120.0)
  65 +.TP
  66 +.B \-\-download_slice_size \fIbytes\fP
  67 +query for \fIbytes\fP bytes per request (default 32768)
  68 +.TP
  69 +.B \-\-request_backlog \fInum\fP
  70 +keep \fInum\fP requests in a single pipe at once (default 5)
  71 +.TP
  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)
  74 +.TP
  75 +.B \-\-timeout \fIsecs\fP
  76 +wait \fIsecs\fP before closing sockets which nothing has been recieved on (default 300.0)
  77 +.TP
  78 +.B \-\-timeout_check_interval \fIsecs\fP
  79 +check whether connections have timed out every \fIsecs\fP seconds (default 60.0)
  80 +.TP
  81 +.B \-\-max_slice_length \fIbytes\fP
  82 +requests from peers larger than \fIbytes\fP bytes are ignored (default 131072)
  83 +.TP
  84 +.B \-\-max_rate_recalculate_interval \fIsecs\fP
  85 +connections that pause longer than \fIsecs\fP seconds are given reduced rate (default 15.0)
  86 +.TP
  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)
  89 +.TP
  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)
  92 +.TP
  93 +.B \-\-display_interval \fIsecs\fP
  94 +update displayed information every \fIsecs\fP seconds (default 0.1)
  95 +.TP
  96 +.B \-\-rerequest_interval \fIsecs\fP
  97 +request more peers every \fIsecs\fP seconds (default 300)
  98 +.TP
  99 +.B \-\-min_peers \fInum\fP
 100 +do not rerequest if we have \fInum\fP peers already (default 20)
 101 +.TP
 102 +.B \-\-http_timeout \fIsecs\fP
 103 +wait \fIsecs\fP seconds before assuming a http connection has timed out (default 60)
 104 +.TP
 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)
 107 +.TP
 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)
 113 +.TP
 114 +.B \-\-check_hashes \fI 1 | 0 \fP
 115 +whether to check hashes on disk (defaults to 1)
 116 +.TP
 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)
 119 +.TP
 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)
 123 +
 124 +.SH SEE ALSO
 125 +.BR bttrack (1),
 126 +.BR btmakemetafile (1),
 127 +.BR btlaunchmany (1).
 128 +
 129 +More information on the \fBBitTorrent\fR protocol used for distributing files is available
 130 +at
 131 +.B http://bitconjurer.org/BitTorrent/protocol.html
 132 +
 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"
 135 +available at
 136 +.B http://bitconjurer.org/BitTorrent/bittorrentecon.pdf
 137 +.br
 138 +.SH AUTHOR
 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
 144 @@ -0,0 +1,31 @@
 145 +.TH "BITTORRENT-MULTI-DOWNLOADER" 1 "Jan 18 2003"
 146 +.SH NAME
 147 +bittorrent-multi-downloader \- multiple file clients for bittorrent
 148 +.SH SYNOPSIS
 149 +.nf
 150 +.B btlaunchmany \fIdirname\fP [ option ... ]
 151 +.B btlaunchmanycurses \fIdirname\fP [ option ... ]
 152 +.fi
 153 +.SH DESCRIPTION
 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.
 158 +.PP
 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.
 163 +.SH OPTIONS
 164 +
 165 +These programs have the exact same options as the normal
 166 +downloaders, which are documented in \fBbittorrent-downloader\fP(1).
 167 +
 168 +.SH SEE ALSO
 169 +.BR bittorrent-downloader (1),
 170 +.BR btmakemetafile (1),
 171 +.BR bttrack (1).
 172 +.br
 173 +.SH AUTHOR
 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
 179 @@ -0,0 +1,2 @@
 180 +.so bittorrent-downloader.1
 181 +
 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
 185 @@ -0,0 +1 @@
 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
 190 @@ -0,0 +1 @@
 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
 195 @@ -0,0 +1 @@
 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
 200 @@ -0,0 +1,2 @@
 201 +.so bittorrent-multi-downloader.1
 202 +
 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
 206 @@ -0,0 +1,52 @@
 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.
 213 +.\"
 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)
 224 +.SH NAME
 225 +btmakemetafile \- program to generate torrent info files for bittorrent
 226 +.SH SYNOPSIS
 227 +.B btmakemetafile \fIfile\fP \fItracker_announce_address\fP [ option ... ]
 228 +.SH DESCRIPTION
 229 +This manual page documents briefly the \fBbtmakemetafile\fP
 230 +command.
 231 +This manual page was written for the Debian distribution
 232 +because the original program does not have a manual page.
 233 +.PP
 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,
 236 +.\" respectively.
 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.
 241 +.PP
 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).
 245 +.SH OPTIONS
 246 +.TP
 247 +.B \-\-piece_size_pow2 \fIarg\fP
 248 +which power of 2 to set the piece size to (default: 18)
 249 +
 250 +.SH SEE ALSO
 251 +.BR bittorrent-downloader (1),
 252 +.BR btrename (1),
 253 +.BR btreannounce (1),
 254 +.BR bttrack (1).
 255 +.br
 256 +.SH AUTHOR
 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
 262 @@ -0,0 +1,43 @@
 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.
 269 +.\"
 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)
 280 +.SH NAME
 281 +btreannounce \- change the announce address of a torrent file.
 282 +.SH SYNOPSIS
 283 +\fBbtreannounce\fP \fIurl\fP \fItorrent\fP [ \fItorrent\fP ... ]
 284 +.SH DESCRIPTION
 285 +This manual page documents briefly the \fBbtreannounce\fP
 286 +command.
 287 +This manual page was written for the Debian distribution
 288 +because the original program does not have a manual page.
 289 +.PP
 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,
 292 +.\" respectively.
 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.
 297 +
 298 +.SH SEE ALSO
 299 +.BR bittorrent-downloader (1),
 300 +.BR btmakemetafile (1),
 301 +.BR btrename (1).
 302 +.br
 303 +.SH AUTHOR
 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
 309 @@ -0,0 +1,44 @@
 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.
 316 +.\"
 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)
 327 +.SH NAME
 328 +btrename \- change the suggested filename inside a bittorrent file
 329 +.SH SYNOPSIS
 330 +\fBbttrack\fP \fItorrent\fP \fInewfilename\fP
 331 +.SH DESCRIPTION
 332 +This manual page documents briefly the \fBbtrename\fP
 333 +command.
 334 +This manual page was written for the Debian distribution
 335 +because the original program does not have a manual page.
 336 +.PP
 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,
 339 +.\" respectively.
 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.
 345 +
 346 +.SH SEE ALSO
 347 +.BR bittorrent-downloader (1),
 348 +.BR btmakemetafile (1),
 349 +.BR btreannounce (1).
 350 +.br
 351 +.SH AUTHOR
 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
 357 @@ -0,0 +1,40 @@
 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.
 364 +.\"
 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)
 375 +.SH NAME
 376 +btshowmetainfo \- display information in bittorrent files
 377 +.SH SYNOPSIS
 378 +\fBbtshowmetainfo\fP \fIfile\fP [ file ... ]
 379 +.SH DESCRIPTION
 380 +This manual page documents briefly the \fBbtshowmetainfo\fP
 381 +command.
 382 +This manual page was written for the Debian distribution
 383 +because the original program does not have a manual page.
 384 +.PP
 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,
 387 +.\" respectively.
 388 +\fBbtshowmetainfo\fP is a program which will display the information
 389 +stored in a bittorrent file.
 390 +
 391 +.SH SEE ALSO
 392 +.BR bittorrent-downloader (1),
 393 +.BR btmakemetafile (1).
 394 +.br
 395 +.SH AUTHOR
 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
 401 @@ -0,0 +1,88 @@
 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.
 408 +.\"
 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)
 419 +.SH NAME
 420 +bttrack \- tracker for bittorrent
 421 +.SH SYNOPSIS
 422 +.B bttrack \fI [ option ... ]
 423 +.SH DESCRIPTION
 424 +This manual page documents briefly the \fIbttrack\fP
 425 +command.
 426 +This manual page was written for the Debian distribution
 427 +because the original program does not have a manual page.
 428 +.PP
 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,
 431 +.\" respectively.
 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
 435 +to other clients.
 436 +.SH OPTIONS
 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.
 440 +.TP
 441 +.B \-\-port \fIportnum\fP
 442 +listen on port \fIportnum\fP (default 80)
 443 +.TP
 444 +.B \-\-dfile \fIfilename\fP
 445 +store recent downloader info in \fIfilename\fP
 446 +.TP
 447 +.B \-\-bind \fIip\fP
 448 +bind to \fIip\fP instead of the default
 449 +.TP
 450 +.B \-\-socket_timeout \fIsecs\fP
 451 +timeout for closing connections (default 15)
 452 +.TP
 453 +.B \-\-save_dfile_interval \fIsecs\fP
 454 +seconds between saving dfile (default 300)
 455 +.TP
 456 +.B \-\-timeout_downloaders_interval \fIsecs\fP
 457 +seconds between expiring downloaders (default 2700)
 458 +.TP
 459 +.B \-\-reannounce_interval \fIsecs\fP
 460 +seconds downloaders should wait between reannouncements (default 1800)
 461 +.TP
 462 +.B \-\-response_size \fInum\fP
 463 +number of peers to send in an info message (default 50)
 464 +.TP
 465 +.B \-\-timeout_check_interval \fIsecs\fP
 466 +time to wait between checking if any connections have timed out (default 5)
 467 +.TP
 468 +.B \-\-nat_check \fI[ 1 | 0 ]\fP
 469 +whether to check back and ban downloaders behind NAT (default 1)
 470 +.TP
 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)
 473 +.TP
 474 +.B \-\-allowed_dir \fIpath\fP
 475 +only allow downloads for .torrents in this directory (default '')
 476 +.TP
 477 +.B \-\-parse_allowed_interval \fImins\fP
 478 +minutes between reloading of allowed_dir (default 15)
 479 +.TP
 480 +.B \-\-show_names \fI[ 1 | 0 ]\fP
 481 +whether to display names from alowed dir (default 1)
 482 +
 483 +.SH SEE ALSO
 484 +.BR bittorrent-downloader (1),
 485 +.BR btmakemetafile (1).
 486 +.br
 487 +.SH AUTHOR
 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).