NAME

Net::BitTorrent::Session::Tracker - Single tier of BitTorrent trackers

CONSTRUCTOR

new ( [ARGS] )

Creates a Net::BitTorrent::Session::Tracker object. This constructor should not be used directly.

See also: Net::BitTorrent::Session::add_tracker( )

METHODS

announce ( )

Asks the tracker for full data including a list of nodes. Announce is also used to let the tracker know when we start, stop and finish downloading.

See also: scrape ( )

as_string ( [ VERBOSE ] )

Returns a 'ready to print' dump of the Net::BitTorrent::Session::Tracker object's data structure. If called in void context, the structure is printed to STDERR.

See also: [id://317520], Net::BitTorrent::as_string()

client ( )

Returns the Net::BitTorrent object related to this tracker.

scrape ( )

Asks the tracker for basic data.

See also: announce ( )

session ( )

Returns the Net::BitTorrent::Session object related to this request.

urls ( )

Returns the list of URLs contained in this tier.

BUGS/TODO

• Does not support UDP or HTTPS trackers.

• While we don't hammer the trackers, the current version of this module does not comply with the current draft of the Multitracker Metadata Extension specification's order of processing.

  See also: http://www.bittorrent.org/beps/bep_0012.html

• We do not send stop and complete announcements when required. This is actually a Net::BitTorrent::Session and Net::BitTorrent::Session::Peer bug.

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.