Alexey Klimkin > P2P-pDonkey > P2P::pDonkey::Met

Download:
P2P-pDonkey-0.05.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.05   Source  

NAME ^

P2P::pDonkey::Met - Perl extension for handling *.met files of eDonkey peer2peer protocol.

SYNOPSIS ^

    use P2P::pDonkey::Met ':server';
    my $servers;
    my $p = readServerMet($ARGV[0]);
    if ($p) {
        printServerMet($p);
    } else {
        print "$ARGV[0] is not in server.met format\n";
    }

    ...

    use P2P::pDonkey::Met ':part';
    foreach my $f (@ARGV) {
        my $p = readPartMet($f);
        if ($p) {
            printPartMet($p);
        } else {
            print "$f is not in part.met format\n";
        }
    }

    ...

    use P2P::pDonkey::Met ':known';
    my $p = readKnownMet($ARGV[0]);
    if ($p) {
        printKnownMet($p);
    } else {
        print "$ARGV[0] is not in known.met format\n";
    }

    ...

    use P2P::pDonkey::Met ':pref';
    my $p = readPrefMet($ARGV[0]);
    if ($p) {
        printPrefMet($p);
    } else {
        print "$ARGV[0] is not in pref.met format\n";
    }

DESCRIPTION ^

The module provides functions for reading, printing and writing *.met files of eDonkey peer2peer protocol.

P2P::pDonkey::Met provides the subroutines for four types of met files: server.met, ...part.met, known.met, pref.met.

server.met

Functions are tagged with ':server'.

unpackServerDesc($buffer, $offset)
    Returns reference to unpacked server description structure.
packServerDesc($p)
    Returns packed string for description $$p.
printServerDesc($p)
    Prints server description to STDOUT.
makeServerDesc($ip, $port, $name, $desc, $nusers, $nfiles, $preference)
    Returns reference to new server description structure. 
unpackServerDescList($buffer, $offset)
    Returns reference to list of server descriptions.
packServerDescList($l)
    Returns packed string for list of descriptions @$l.
printServerDescList($l)
    Prints items of list @$l to STDOUT.
unpackServerDescListU($buffer, $offset)
    Returns reference to hash of server descriptions. Keys are idAddr($ip, $port).
packServerDescListU($h)
    Returns packed string for hash of descriptions %$h.
printServerDescListU($h)
    Prints values of hash %$h to STDOUT.
unpackServerMet($buffer, $offset)
    Returns reference to hash of server descriptions.
packServerMet($h)
    Returns packed string in server.met file format.
printServerMet($buffer, $offset)
    Alias to printServerDescListU($buffer, $offset).
readServerMet($filename)
    Reads file and unpacks data with unpackServerMet() function.
writeServerMet($filename, $h)
    Packs %$h with packServerMet() function and writes to file.

...part.met

Functions are tagged with ':part'.

unpackPartMet($buffer, $offset)
    Returns reference to file information structure.
packPartMet($p)
    Returns packed string in part.met format.
printPartMet($p)
    Prints file information to STDOUT.
readPartMet($filename)
    Reads file and unpacks data with unpackPartMet() function.
writePartMet($filename, $p)
    Packs $$p with packPartMet() function and writes to file.

known.met

Functions are tagged with ':known'.

unpackKnownMet($buffer, $offset)
    Returns reference to list of file information structures.
packKnownMet($l)
    Returns packed string in known.met format.
printKnownMet($l)
    Prints elements of list @$l to STDOUT.
readKnownMet($filename)
    Reads file and unpacks data with unpackKnownMet() function.
writeKnownMet($filename, $l)
    Packs @$p with packKnownMet() function and writes to file.

pref.met

Functions are tagged with ':pref'.

unpackPrefMet($buffer, $offset)
    Returns reference to hash:

        IP => $ip 
        Port => $port 
        Hash => $hash 
        Meta => $meta 
        Pref => $pref
packPrefMet($p)
    Returns packed string in pref.met format.
printPrefMet($p)
    Print file information to STDOUT.
readPrefMet($filename)
    Reads file and unpacks data with unpackPrefMet() function.
writePrefMet($filename, $p)
    Packs $$p with packPrefMet() function and writes to file.

EXPORT

None by default.

AUTHOR ^

Alexey Klimkin, <klimkin@mail.ru>

SEE ALSO ^

perl, P2P::pDonkey::Meta.

eDonkey home:

    <http://www.edonkey2000.com/>

Basic protocol information:

    <http://hitech.dk/donkeyprotocol.html>

    <http://www.schrevel.com/edonkey/>

Client stuff:

    <http://www.emule-project.net/>

    <http://www.nongnu.org/mldonkey/>

Server stuff:

    <http://www.thedonkeynetwork.com/>
syntax highlighting: