Net::BitTorrent::Util - BitTorrent Related Utility Functions


Net-BitTorrent documentation  | view source Contained in the Net-BitTorrent distribution.

Index


NAME

Top

Net::BitTorrent::Util - BitTorrent Related Utility Functions

Importing From Net::BitTorrent::Util

Top

By default, nothing is exported.

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

:all

Everything is imported into your namespace.

:bencode

You get the two Bencode-related functions: bencode and bdecode. For more on Bencoding, see the BitTorrent Protocol documentation.

:compact

Imports the tracker response-related functions compact and uncompact.

Functions

Top

bencode ( ARGS )

Expects a single value (basic scalar, array reference, or hash reference) and returns a single string.

Bencoding is the BitTorrent protocol's basic serialization and data organization format. The specification supports integers, lists (arrays), dictionaries (hashes), and byte strings.

bdecode ( STRING )

Expects a bencoded string. The return value depends on the type of data contained in the string.

compact ( LIST )

Compacts a list of IPv4:port strings into a single string.

A compact peer is 6 bytes; the first four bytes are the host (in network byte order), the last two bytes are the port (again, in network byte order).

uncompact ( STRING )

Inflates a compacted string of peers and returns a list of IPv4:port strings.

See Also

Top

The BitTorrent Protocol Specification

http://bittorrent.org/beps/bep_0003.html#the-connectivity-is-as-follows

BEP 32: Tracker Returns Compact Peer Lists

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

Convert::Bencode
Bencode
Convert::Bencode_XS

Author

Top

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

CPAN ID: SANKO

License and Legal

Top


Net-BitTorrent documentation  | view source Contained in the Net-BitTorrent distribution.