ofproto: Rename "private.h" to "ofproto->provider.h".
[openvswitch] / third-party / README
1 This directory contains third-party software that may be useful for
2 debugging.
3
4 tcpdump
5 -------
6 The "ofp-tcpdump.patch" patch adds the ability to parse OpenFlow
7 messages to tcpdump.  These instructions assume that tcpdump 3.9.8 
8 is going to be used, but it should work with other versions that are not
9 substantially different.  To begin, download tcpdump and apply the
10 patch:
11
12     wget http://www.tcpdump.org/release/tcpdump-3.9.8.tar.gz
13     tar xzf tcpdump-3.9.8.tar.gz
14     ln -s tcpdump-3.9.8 tcpdump
15     patch -p0 < ofp-tcpdump.patch
16
17 Then build the new version of tcpdump:
18
19     cd tcpdump
20     ./configure
21     make
22
23 Clearly, tcpdump can only parse unencrypted packets, so you will need to
24 connect the controller and datapath using plain TCP.  To look at the
25 traffic, tcpdump will be started in a manner similar to the following:
26
27     sudo ./tcpdump -s0 -i eth0 port 6633
28
29 The "-s0" flag indicates that tcpdump should capture the entire packet.
30 If the OpenFlow message is not received in its entirety, "[|openflow]" will 
31 be printed instead of the OpenFlow message contents.
32
33 The verbosity of the output may be increased by adding additional "-v"
34 flags.  If "-vvv" is used, the raw OpenFlow data is also printed in
35 hex and ASCII.