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
  14 Usage is pretty simple:
  15 dccp2tcp dccp_file tcp_file [-d] [-y] [-g] [-s]
  16         -d is debug
  17         -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).
  18         -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.
  19         -s converts the DCCP ack vector to TCP SACKS.
  20
  21 For typical usage, you probably just want -s.
  22
  23
  24 This program does have several important limitations:
  25         1)Supports only a single DCCP contection per capture.
  26         2)Source Port can't equal Destination Port. If the two are equal, this program will get very confused.
  27         3)DCCP MUST use 48 bit sequence numbers.
  28         4)Checksums are not computed (they are zeroed).
  29         5)Only converts those packet types used by the Linux implementation at this date
  30         6)DCCP Ack packets show up as TCP packets containing one byte
  31         7)Very little error checking of packet headers, it's research software afterall
  32
  33
  34
  35 dccp2tcp is free software: you can redistribute it and/or modify
  36 it under the terms of the GNU General Public License as published by
  37 the Free Software Foundation, either version 3 of the License, or
  38 (at your option) any later version.
  39
  40 dccp2tcp is distributed in the hope that it will be useful,
  41 but WITHOUT ANY WARRANTY; without even the implied warranty of
  42 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  43 GNU General Public License for more details.
  44
  45 You should have received a copy of the GNU General Public License
  46 along with dccp2tcp.  If not, see <http://www.gnu.org/licenses/>.
  47
  48
  49 Copyright 2010
  50 Samuel Jero
  51 Computer Science student, Ohio University
  52 sj323707@ohio.edu