README
1Name
2 Net::BitTorrent - BitTorrent peer-to-peer protocol class
3
4Synopsis
5 use Net::BitTorrent;
6
7 my $client = Net::BitTorrent->new();
8
9 $client->on_event(
10 q[piece_hash_pass],
11 sub {
12 my ($self, $args) = @_;
13 printf(qq[pass: piece number %04d of %s\n],
14 $args->{q[Index]}, $args->{q[Torrent]}->infohash);
15 }
16 );
17
18 my $torrent = $client->add_torrent({Path => q[a.legal.torrent]})
19 or die q[Cannot load .torrent];
20
21 $torrent->hashcheck; # Verify any existing data
22
23 $client->do_one_loop() while 1;
24
25Description
26 "Net::BitTorrent" is a class based implementation of the current
27 BitTorrent Protocol Specification. Each "Net::BitTorrent" object is
28 capable of handling several concurrent .torrent sessions.
29
30Installation
31 This distribution uses "Module::Build" for installation, so use the
32 following procedure:
33
34 perl Build.PL
35 ./Build
36 ./Build test
37 ./Build install
38
39Bugs
40 Please see the Todo file included with this distribution,
41 perldoc Net::BitTorrent, and perldoc Net::BitTorrent::TODO, and
42 http://sankorobinson.com/net-bittorrent/ for more information.
43
44Author
45 Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/
46
47 CPAN ID: SANKO
48
49License and Legal
50 Copyright (C) 2008-2009 by Sanko Robinson <sanko@cpan.org>
51
52 This program is free software; you can redistribute it and/or modify it
53 under the terms of The Artistic License 2.0. See the LICENSE file
54 included with this distribution or
55 http://www.perlfoundation.org/artistic_license_2_0. For clarification,
56 see http://www.perlfoundation.org/artistic_2_0_notes.
57
58 When separated from the distribution, all POD documentation is covered
59 by the Creative Commons Attribution-Share Alike 3.0 License. See
60 http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For
61 clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.
62
63 Neither this module nor the Author is affiliated with BitTorrent, Inc.
64
65$Id: README 64e98b0 2009-09-12 05:23:14Z sanko@cpan.org $
66