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
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/>