btget

Langue: en

Version: December 2005 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

btget - Attach to a BitTorrent P2P cloud and retrieve or share a set of files

SYNOPSIS

btget [OPTION]... [TORRENT]...

DESCRIPTION

BitTorrent is a peer to peer protocol for transfer of large datasets. Optimal use of BitTorrent requires appropriate configuration of your firewall so that other peers can reach your peer, but BitTorrent will also work at a diminished level through a firewall and NAT proxy. The TORRENT parameter should be a special .torrent file that describes the dataset to be transferred, or with the use of the -u option can be a URL from which to obtain the .torrent file.

-h
show a short help message
-f[=FILE]
torrent datasets may list multiple files to be transferred.
With the '-f' option a single FILE may be transferred from the torrent. Btget will request the minimum amount of data from the other peers to complete the file
-q[=TIMEOUT]
once all peers are complete and TIMEOUT seconds have elapsed, btget will exit
-b
disable snubbing detection
-t[=IMEOUT]
progress report interval
Changes the reporting interval to the value specified
-u
treat the TORRENT parameter as a URL and retrieve the .torrent file from that server
-e[=RATIO]
exaggerate upload rates when talking to the tracker.
Default RATIO is 1.0, while large values will over-state upload totals, and lower numbers will under-state upload totals.
-i[=BADTRACKER]
ignore multi-tracker entries that list BADTRACKER.
Some torrents include multiple tracker entries. With this flag you can tell btget to ignore one or more of the trackers listed in a multi-tracker record. BADTRACKER is a string which causes an entry to be ignored if it appears anywhere within the tracker URL.
-s
seed the torrent without checking file integrity. This will skip the file verification step and assume that all blocks are ok
-v
dump continuous updates about the state of the transfer and about each peer to which we are connected.

By default, btget will listen on the first available port in the range 6881-6889. Configuring your firewall so that your btget client is reachable on those ports will ensure that you can connect to the largest possible set of peers, which will in turn maximize your throughput.

ENVIRONMENT VARIABLES

Start of port range for incoming connections
End of port range for incoming connections

FILES

./.libbtrc holds the random identifier used to uniquely identify this peer with the tracker.

AUTHOR

Written by Kevin Smathers and all of the authors listed in CREDITS

REPORTING BUGS

Report bugs at <http://www.sf.net/projects/libbt> Copyright © 2004 Kevin Smathers, et. al.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

KNOWN BUGS

The '-f' option cannot be stacked.

SEE ALSO

btlist(1), btcheck(1)