RT-Parse

An analysis tool for tracing RTPS interactions within PCAP (TShark) capture files

Status

Building

Setup

• Install CMake (developed using cmake 3.12.1)
• Install make (developed using GNU make 4.2.1)
• Install a modern C++ compiler (developed using g++ 8.2.0)
• Install Boost C++ libraries (only used for program options) (developed using 1.67.0)

Clone

• Clone this repository to your local machine using https://github.com/simpsont-oci/rtparse
• Switch into cloned directory

Building

Run CMake to generate Makefiles

$ cmake .

Run make

$ make

Running

To see a list of available command parameters, run with --help

$ ./rtparse --help

RT-Parse currently only runs against the tshark verbose output from a RTPS pcap file

$ tshark -r example.pcapng -V | tee example.tshark.verbose.txt
$ ./rtparse --file example.tshark.verbose.txt

Contributing / Future Work

A few thoughts for future development

• Support for parsing version / vendor as opposed to just assuming OpenDDS
• Separation of frames summary and frames output (split --show-conversation-frames)
• Support for parsing & frames output for raw pcap files (bypassing tshark, allowing frames to be reloaded into pcap analysis tool like wireshark)
• Support for parsing / analyzing DATA_FRAG, HEARTBEAT_FRAG, and NACK_FRAG submessages
• Support for filtering by "end" of conversation (make use of unregister / dispose messages)
• Latency and throughput analysis?
• Additional support for security?

License

• BDS-3-Clause
• Copyright 2019 © OCI