File Coverage

blib/lib/Net/BitTorrent/Protocol/BEP09.pm

Criterion	Covered	Total	%
statement	15	21	71.4
branch			n/a
condition			n/a
subroutine	5	8	62.5
pod	3	3	100.0
total	23	32	71.8

package Net::BitTorrent::Protocol::BEP09;
use strict;
use warnings;
our $VERSION = "1.5.1";
use Net::BitTorrent::Protocol::BEP03::Bencode qw[bencode];
use vars qw[@EXPORT_OK %EXPORT_TAGS];
use Exporter qw[];
*import = *import = *Exporter::import;
%EXPORT_TAGS = (
    build => [
        qw[build_metadata_request build_metadata_data build_metadata_reject]
    ],
    parse => [qw[ ]]    # XXX - None required
);
@EXPORT_OK = sort map { @$_ = sort @$_; @$_ } values %EXPORT_TAGS;
$EXPORT_TAGS{'all'} = \@EXPORT_OK;

#
sub build_metadata_request ($) {
    my ($index) = @_;
    return
        bencode({piece => $index,
                 msg_type => 0
                }
        );
}

sub build_metadata_data ($$) {
    my ($index, $data) = @_;
    return
        bencode({piece => $index,
            total_size=> length($data),
                 msg_type => 1
                }
        ) . $data;
}

sub build_metadata_reject ($) {
    my ($index) = @_;
    return
        bencode({piece => $index,
                 msg_type => 2
                }
        );
}

1;

=pod

=head1 NAME

Net::BitTorrent::Protocol::BEP09 - Packet Utilities for BEP09: The Extention for Peers to Send Metadata Files

=head1 Description

The purpose of this extension is to allow clients to join a swarm and complete
a download without the need of downloading a .torrent file first. This
extension instead allows clients to download the metadata from peers. It makes
it possible to support I, a link on a web page only containing
enough information to join the swarm (the info hash).

This metadata extiontion uses the
L to advertise its
existence. It adds the C entry to the C dictionary in the
extention header handshake message. It also adds C to the
handshake message (not the C dictionary) specifiying an integer value of
the number of bytes of the metadata.

=head1 Importing From Net::BitTorrent::Protocol::BEP09

By default, nothing is exported.

You may import any of the following or use one or more of these tag:

=over

=item C<:all>

Imports everything. If you're importing anything, this is probably what you
want.

=item C<:build>

Imports the functions which generate messages.

=back

Note that there are no parser functions as the packets generated for BEP09 are
simple bencoded hashes. Use the
L.

=head1 Functions

This extention is very simple; there's a single request packet type and only
two possible reply packet types:

=over

=item C

Generates an appropriate request for a subpiece of the torrent's metadata.

=item C

Generates an appropriate reply to a
L.

=item C

Generates an appropriate reply to a
L if the requested piece
is not available.

=back

=head1 Magnet URI Format

The magnet URI format is:

    magnet:?xt=urn:btih:&dn=&tr=

Where C is the infohash, hex encoded, for a total of C<40>
characters. For compatability with existing links in the wild, clients should
also support the C<32> character base32 encoded infohash.

=head1 See Also

=over

=item BEP 09: Extention for Peers to Send Metadata Files

http://bittorrent.org/beps/bep_0009.html

=back

=head1 Author

Sanko Robinson  - http://sankorobinson.com/

CPAN ID: SANKO

=head1 License and Legal

Copyright (C) 2010-2014 by Sanko Robinson

This program is free software; you can redistribute it and/or modify it under
the terms of
L.
See the F file included with this distribution or
L
for clarification.

When separated from the distribution, all original POD documentation is
covered by the
L.
See the
L.

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

=cut