third-party/README.md

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