The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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

Methods

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: Net::BitTorrent

get_client ( )

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

get_session ( )

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

get_urls ( )

Returns the list of URLs contained in this tier.

See Also: add_url( ), remove_url( )

add_url ( URL )

Adds a new tracker url to this tier.

See Also: remove_url( ), get_urls( )

remove_url ( URL )

Removes a tracker from the list in this tier.

This method is a NOOP. See the next release...

See Also: add_url( ), get_urls( )

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 5.10 (or higher). See http://www.perl.com/perl/misc/Artistic.html or the LICENSE file included with this distribution.

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.