NAME
    Net::BitTorrent - BitTorrent peer-to-peer protocol

SYNOPSIS
    use Net::BitTorrent;

    sub hash_pass {
        my ($self, $piece) = @_;
        printf(qq[hash_pass: piece number %04d of %s\n],
               $piece->index, $piece->session);
    }

    my $client = Net::BitTorrent->new();
    $client->set_callback(q[piece_hash_pass], \&hash_pass);

    # ...
    # set various callbacks if you so desire
    # ...

    my $torrent = $client->add_session({path => q[a.legal.torrent]})
        or die q[Cannot load .torrent];

    while (1) {
        $client->do_one_loop();

        # Etc.
    }

DESCRIPTION
    "Net::BitTorrent" is a class based implementation of the latest
    BitTorrent Protocol Specification. Each "Net::BitTorrent" object is
    capable of handling several concurrent .torrent sessions.

INSTALLATION
    This distribution uses "Module::Build" for installation, so use the
    following procedure:

      perl Build.PL
      ./Build
      ./Build test
      ./Build install

BUGS
    Please see the Todo file included with this distribution. Found
    bugs that are not already listed should be reported through
    L<http://code.google.com/p/net-bittorrent/issues/list>.  Please
    include as much information as possible.

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

    CPAN ID: SANKO

LICENSE AND LEGAL
    Copyright 2008 by Sanko Robinson <sanko@cpan.org>

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself. See
    <http://www.perl.com/perl/misc/Artistic.html> or the LICENSE file
    included with this module.

    All POD documentation is covered by the Creative Commons
    Attribution-Noncommercial-Share Alike 3.0 License
    (<http://creativecommons.org/licenses/by-nc-sa/3.0/us/>).

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

$Id: README 18 2008-04-25 01:14:52Z sanko@cpan.org $
