Trace Receiver - trtpd
Purpose
The Trace Receiver is a graphical client that receives and splits trace dump data through a socket.
Syntax
trtpd [<options>] [<file> [, <file>]]
where:
-
<file> is one or several dynamic trace output files
<options> is a set of optional parameters
Description
If a set of user-defined I/O functions uses sockets in a customized Target Deployment Port (TDP), the Trace Receiver can be used to receive the dump data and to split the trace files on-the-fly. Use the Target Deployment Port Editor to customize the TDP.
The Trace Receiver uses its own graphical user interface to display reception and split progression.
To use the Trace Receiver, you must:
-
Customize the TDP to produce trace buffer output through a socket by setting the SOCKET_UPLOAD setting of the TDP to True
Specify a delimiter character in the SOCKET_UPLOAD_DELIMITER setting of the TDP
The Runtime Trace Receptor uses the delimiter to find useful trace data and directs the output to the trace file formats. If no filenames are provided, the following files are produced:
-
testing.rio for Component Testing output to be processed by a Report Generator
purifylt.tpf for Memory Profiling data
quantifylt.tqf for Performance Profiling data
attolcov.tio for Code Coverage data
tracer.tdf for Runtime Tracing data
Options
-p|--port <number>
Port number. Specifies the decimal number of the port. The default port number is 7777.
-d|--delimiter <delimiter-byte>
Delimiter byte. Specified the decimal number of the delimiter byte. The default number is 94 ("^" in ASCII).
-o|--oneshot
Oneshot. Exits the Trace Receiver when the first client closes.
Example
The following trace dump is sent to the socket, using the "^" character as a delimiter:
...
^TU "ms"
SF 1 1dch 9527b66bh
TI 1 1 5
TM 726h
HS 95fch
ME 3 1
NI 6 1
SF 2 10edh 72cbacbch
TM b68h
HS bea4h
^ ...
Use the following command line to receive and split the trace dump into the correct output file formats.
trtpd --port 7778 --delimiter 95 -o c:\\temp\\coverage.tio
c:\\temp\\trace.tdf c:\\temp\\profiling.tqf
You can also launch the Trace Receiver with no parameters. In this case, default parameters are assumed:
trtpd
Related Topics