NAME

bittorrent - Very basic example BitTorrent client

Description

This is a very basic demonstration of a full Net::BitTorrent-based client.

Synopsis

 bittorrent file.torrent
   or
 bittorrent [options] [file ...]

 Options:
   -t     --torrent     .torrent file to load
   -p     --port        TCP/UDP port opened for incoming connections
   -d     --directory   Base directory to store downloaded files
   --no-check           Skip integrity check at start
   --options            Advanced settings
   -?     --help        Display full documentation
   --version            Display version information

To get client-wide progress updates, press Ctrl+C. For more, see perldoc.

Options

--torrent

Open this .torrent file.

You may pass several -torrent parameters and load more than one .torrent torrent.

--port

Port number opened to the world for incoming connections. This defaults to 0 and lets Net::BitTorrent bind to a random, unused port.

--directory

Relative or absolute directory used as a base directory for storage. By default, this is the current working directory.

Please see Net::BitTorrent::Torrent for related information.

--no-check

If found, the files will not be checked for integrity and we assume that we have none of the data of this torrent.

--options

Allows otherwise private settings to be changed. For example, to set the upload bandwidth limit...

  bittorrent --options _set_max_ul_rate=8192 [...]

You may pass several --options parameters.

--version

Guess.

See Also

For more examples, see the files under the /tatoeba/ directory.

Author

Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

CPAN ID: SANKO

License and Legal

Copyright (C) 2008 by Sanko Robinson <sanko@cpan.org>

This program is free software; you can redistribute it and/or modify it under the terms of The Artistic License 2.0. See the LICENSE file included with this distribution or http://www.perlfoundation.org/artistic_license_2_0. For clarification, see http://www.perlfoundation.org/artistic_2_0_notes.

When separated from the distribution, all POD documentation is covered by the Creative Commons Attribution-Share Alike 3.0 License. See http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.

Neither this module nor the Author is affiliated with BitTorrent, Inc.