sjero.net Git - dccp2tcp/blob - README

   1 This program converts a DCCP (Datagram Congestion Control Protocol) packet capture
   2 in PCAP format into a TCP packet capture in PCAP format with the intention that
   3 that capture be analysed with tcptrace (http://www.tcptrace.org) in order to generate
   4 graphs/stats to understand the DCCP protocol.
   5
   6
   7 In order to build this program, please simply type make at the commandline. I have not
   8 included a ./configure script with this program because this program will only compile
   9 on linux anyway (we need the dccp header include file) and it comprises only one file.
  10 If you have problems, simply modify the make file as needed. Contact me, if major problems
  11 arise.
  12
  13 In order to utilize this program effectively you will also need Tcptrace, which you can download
  14 from http://www.tcptrace.org and the version of xplot available from http://www.tcptrace.org under
  15 "Useful Companion Programs" (Note! This is not the xplot that is in the Ubuntu repositories).
  16
  17
  18 Usage is pretty simple:
  19 dccp2tcp dccp_file tcp_file [-d] [-V] [h] [-y] [-g] [-s]
  20         -d is debug
  21         -V is Version information
  22         -h is help
  23         -y shifts the window line in tcptrace (yellow) to the highest received acknowledgment. Normally this line is just a constant amount more than the ack number(i.e. useless).
  24         -g shifts the ack line in tcptrace (green) to the highest received acknowledgment. Normally this line is the standard TCP ack number, which, for DCCP, translates to the highest contiguous acknowledgement in the ack vector.
  25         -s converts the DCCP ack vector to TCP SACKS. Specify -s twice to only see those Ack vectors with a loss interval in them. This is convenient way to see loss events.
  26
  27 For typical usage, you probably want -s -s.
  28
  29 Once you run dccp2tcp, you will then want to run tcptrace on the tcp_file to generate graphs. The command should be something like this:
  30 tcptrace -lGt tcp_file
  31
  32 You can then use xplot to view the resulting graphs, like this:
  33 xplot a2b_tsg.xpl a2b_rtt.xpl
  34
  35 One important note on interpreting the graphs is that DCCP Ack packets show up
  36 as TCP packets containing one byte.
  37
  38 Finally, an important limitation of this program is that DCCP MUST use 48 bit
  39 sequence numbers. dccp2tcp will complain at you if you try to process a connection
  40 with short sequence numbers.
  41
  42 dccp2tcp is free software: you can redistribute it and/or modify
  43 it under the terms of the GNU General Public License as published by
  44 the Free Software Foundation, either version 3 of the License, or
  45 (at your option) any later version.
  46
  47 dccp2tcp is distributed in the hope that it will be useful,
  48 but WITHOUT ANY WARRANTY; without even the implied warranty of
  49 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  50 GNU General Public License for more details.
  51
  52 You should have received a copy of the GNU General Public License
  53 along with dccp2tcp.  If not, see <http://www.gnu.org/licenses/>.
  54
  55
  56 Copyright 2013
  57 Samuel Jero
  58 Masters Student
  59 Internetworking Research Group
  60 Ohio University
  61 sj323707@ohio.edu