NAME

       gnome-btdownload - download files using a scatter-gather network

SYNOPSIS

       gnome-btdownload [ option ... ] URL
       gnome-btdownload [ option ... ] filename

DESCRIPTION

       gnome-btdownload  is  a  program  to  allow  a  user to download files using bittorrent, a
       scatter-gather network.

OPTIONS

       These programs follow the usual GNU command line syntax, with long options  starting  with
       two dashes (`-').  A summary of options is included below.

       --responsefile filename
              treat  filename as a file which the server reponse was stored in. If this option is
              used, no filename or URL should be present on the command line.

       --url url
              retrieve the torrent info file from url.  If this option is used,  no  filename  or
              URL should be present on the command line.

       -i ip | --ip ip
              report ip as your IP to the tracker

       --bind ip
              bind to ip instead of the default

       --minport portnum
              set  portnum  as  the  minimum port to listen on, counts up if unavailable (default
              6881)

       --maxport portnum
              set portnum as the maximum port to listen on (default 6889)

       --saveas filename
              store the downloaded file to filename, instead of querying user (gui) or using  the
              filename stored in the torrent info file

       --max_uploads num
              Only allow num uploads at once (default 4)

       --max_upload_rate kbytes
              maximum rate to upload at in kilobytes, 0 means no limit (default 0)

       --keepalive_interval secs
              pause secs seconds between sending keepalives (default 120.0)

       --download_slice_size bytes
              query for bytes bytes per request (default 32768)

       --request_backlog num
              keep num requests in a single pipe at once (default 5)

       --max_message_length bytes
              set  bytes  to  the  maximum  length  prefix encoding you'll accept over the wire -
              larger values get the connection dropped (default 8388608)

       --timeout secs
              wait secs before closing sockets which nothing has been received on (default 300.0)

       --timeout_check_interval secs
              check whether connections have timed out every secs seconds (default 60.0)

       --max_slice_length bytes
              requests from peers larger than bytes bytes are ignored (default 131072)

       --max_rate_recalculate_interval secs
              connections that pause longer than secs seconds are  given  reduced  rate  (default
              15.0)

       --max_rate_period secs
              set  secs  to  the  maximum  amount  of  time  to  guess  the current rate estimate
              represents (default 20.0)

       --upload_rate_fudge secs
              set the time equivalent of writing to kernel-level TCP buffer to secs (default 5.0)

       --display_interval secs
              update displayed information every secs seconds (default 0.1)

       --rerequest_interval secs
              request more peers every secs seconds (default 300)

       --min_peers num
              do not rerequest if we have num peers already (default 20)

       --http_timeout secs
              wait secs seconds before assuming a http connection has timed out (default 60)

       --snub_time secs
              wait secs seconds for data to come in over a connection before assuming it's  semi-
              permanently choked (default 30.0)

       --spew  1 | 0
              whether to display diagnostic info to stdout.  This option is not useful when using
              btdownloadcurses or btdownloadgui. (default 0) --max_initiate num  stop  initiating
              new connections when we have num peers (default 40)

       --check_hashes  1 | 0
              whether to check hashes on disk (defaults to 1)

       --report_hash_failures  1 | 0
              whether  to  report  to the user that hash failuers occur (non-fatal, common error)
              (default 0)

       --rarest_first_priority_cutoff num
              the number of peers which need to have a piece before other partials take  priority
              over rarest first (default 3)

SEE ALSO

       bittorrent-downloader(1), bttrack(1), btmakemetafile(1), btlaunchmany(1).

AUTHOR

       This  manual  page was originally written by Michael Janssen <jamuraa@debian.org>, for the
       Debian  GNU/Linux  system's  bittorrent-downloader(1)  and   was   modified   for   gnome-
       btdownload(1)  by  Paul  Varga  <null_and_void@users.sourceforge.net>  (but may be used by
       others).

                                           Sep 24 2003                        GNOME-BTDOWNLOAD(1)