patch #7140
[mldonkey.git] / tools / pandora / README
blobb0d6a31796b3e475b9b12a5378c8499f7f2b5814
1 This directory contains some useful files to use Pandora with MLdonkey.
3 stacks: contains the description of a stack that takes a file
4    'trace.dump' and output the trace in a better format, using the
5    tcpprint component also provided.
7 tcpprintcomponent.cc: this component prints the packets as a set of
8    calls to ocaml functions.
10 The output of these components can be used directly by mldonkey.
12 Example:
14 1) You have a trace generated by ethereal 'kazaa.dump'. In pandora/src,
15 do (you need to have replaced the stacks file, and compiled pandora with
16 the new tcpprintcomponent.cc in pandora/pandora_components/).
18 cp kazaa.dump trace.dump
19 ./pandora -s separator > kazaa.ml
21 2) Now, you have a file kazaa.ml, edit it and add at the beginning:
23 ================================ BEGIN ADD
24 open FasttrackServers;;
25 open Pandora;;
27 let _ =
28 ================================= END ADD 
30 and at the end:
31 ================================ BEGIN ADD
32 commit ();;
33 ================================= END ADD 
35 3) Now, execute the file in mldonkey/:
37 make runtop < kazaa.ml > kazaa.txt
39 4) This is only possible because src/networks/fasttrack/fasttrackServers.ml
40 contains a module Pandora, that defines how to print the traces.
41 You can also use this feature for Gnutella and Gnutella2 traces.