First step for using multiple recvs from mptp.
[swifty.git] / src / libswift / README
1 swift: the multiparty transport protocol
2     (aka BitTorrent at the transport layer)
3     Differently from TCP, the protocol does not use the ordered data stream
4     abstraction. Effectively, it splits a file into 1KB packets and sends
5     them around. The secret sauce is Merkle hash trees and binmaps.
6  
7     Requires libevent-2.0 or higher.
8
9 see doc/index.html for marketing stuff, ideas and rants
10     doc/draft-ietf-ppsp-grishchenko-swift.txt for protocol draft spec
11     *.cpp for the actual code
12     swift.cpp is the main exec file; may run as e.g.
13     
14         ./swift -t node300.das2.ewi.tudelft.nl:20000 -h \
15         d1502706c46779d361a1d562a10da0a45c4c40e5 -f \
16         trailer.ogg
17         
18     ...to retrieve video and save it to a file.
19
20     Alternatively, you might play with the HTTP gateway, the preliminary
21     version. First, run the seeder-tracker: 
22
23         $ ./swift -f ~/Downloads/big_buck_bunny_480p_stereo.ogg -l 0.0.0.0:20000
24         Root hash: 7c462ad1d980ba44ab4b819e29004eb0bf6e6d5f
25
26     ...then you may try running the swift-HTTP gateway...
27
28         $ ./swift -t 127.0.0.1:20000 -g 0.0.0.0:8080 -w
29
30     ...and finally you may point your browser at the gateway...
31
32         http://127.0.0.1:8080/7c462ad1d980ba44ab4b819e29004eb0bf6e6d5f
33
34     If you use an HTML5 browser (Chrome preferred), you are likely to see
35     the bunny trailer at this point...