First you need to download necessary files which you can find Fast Start section
In general ther are two ways of using TracesPlay in MATLAB.
The first is
where command is a string which form is described in General Descripiton section.
The second way is
where all option and parameter variables are strings. Parameters following an option are specific for the option. The detailed descripiton of existing options and parameters is given in General Descripiton section.
Comand Line Application
For command line application you use
where TracesPlay is a compiled application, command is described in details in General Descripiton section and file_name is a cvs file name.
General Description
For both MATLAB and command line application a command string has to be specified. In this section detailed description of command construction is given.
The command string is
where option list is given here. Parameters following an option are option dependent.
List of the Most Important Parameters
-o set what type of field from protocol shall be output data. The supported fields are given here
-r (file name) - files name that shall be analyzed
Full List of TracesPlay Parameters
-o
set what fields' type are read. The supported fields are given here
-r (file name)
files name that shall be analyzed
-n
analyzed packet range. The range parameters are given here
-w (file_name)
write date to file in csv format (not supported in matlab)
-version
display program compile date
-a
always give date, even if they wasn't all filed in data
-c
write header to file
-m
check memmory block size
-h
display short help
-s
print on screen basic info (default disable in MATLAB function)
-ss
print on screen protocol information (value of protocol fields)
-test
execut small test to check memory size and other important parameters
-f
enable filter. The filter parameters are given here
-e
enable showing error comunicate
-u (in_format) (force_format)
force payload type (in_format) as protocol (force_format)
now avaliable only: RTP, NETFLOW for UDP payload
-setLisner New (v. 0.2)
!!Only for MATLAB !! allow to run own matlab function from TracesPlay.
Example of use is here
Supported Formats and Force-type Format
TracesPlay is able to read formats PCAP, ERF, TSH, FR and FR+ also Snoop v2 (for ver 0.1.3)
Program have simple algorytm to auto recognize format type and simple metod to force-type format we need enter format type after file name:
where format_type can be:
pcap
for PCAP format
cap
for PCAP format
erf
for ERF format
tsh
for TSH format
fr
for FR format
clr
for CLR format
snoop
for Snoop v2 format
lc
for Live caputre data from network device. It need TracesPlay version that work with PCAP library New (v. 0.2)
h264
for H264 stream stored in file with out extra stream New (v. 0.2)
Some example of use:
Filter parameters
will be added
Range parameters
Range is defined by
where start is the first analysed packet position and end is the last analysed packet position.
-1 means the first or the last packet for start and end respectively.
reads first 100 packets
reads packets from 101 to 200
reads packets from 500 to the last one.
Supported Protocol Fields
Heare are describe only most used protocol frame, for more protocol detail fields specification.
Full list of supported protocol fileds can be find here
Packet Information
"HEADER.time" - only for data writen in csv
"HEADER.timeS" - packet caputre seconds time
"HEADER.timeUs" - packet caputre micro seconds time
"HEADER.erfTime" - ERT time format
"HEADER.int"
"HEADER.len" - capture data lenght
"HEADER.wLen" - data in wirless"
"PACKET.num" - number of packet from traces
PCAP
All possible value are defined in Packet Information.
ERF
ERF.flags
ERF.type
ERF.lctrcolor
TSH
All possible value are defined in Packet Information.
FR+
All possible value are defined in Packet Information.
FR
All possible value are defined in Packet Information.
SNOOP
All possible value are defined in Packet Information.
