Trace Probe Processor - parsecode.pl

When using the Probe runtime analysis feature of the product, the Probe Processor takes C source files and message definition files and generates a set of source files containing the message trace functions called by the probe macros.

Syntax

parsecode.pl [<options>] {<msg_files> [, <msg_files>]} {<source> [, <source>]}

where:

<msg_files> are .h message type definition files

<source> are probed C source files

<options> is a set of optional parameters among those described below.

Definition

The Probe Processor is is only available for the C language.

The message traces are written to a .rio output file, one for each instance. The probed binary is produced by compiling the atlprobe.c file, which is generated by the Probe Processor, and linked to the application object files with the Target Deployment Port.

Optional Parameters

[-mode=DEFAULT|CUSTOM]

Default mode writes the .rio output file on-the-fly. In this case, the atl_dump_trace macro is not required.

Custom mode allows the probes to write traces to a temporary location, such as memory, a stack or a buffer file. In custom mode, the traces are flushed to the .rio file only when an atl_dump_trace macro is encountered.

The I/O functions for probe trace output to the temporary location are defined in the probecst.c source file delivered with the product. You can modify this file to adapt the probe mechanism to your application and platform.

In custom mode, the compilation and link phase generates write operations from the probed application and the probecst.c file, and read operations from the atlprobe.c, probecst.c files and the TP.o Target Deployment Port file.

[-preopts=-INCL= <include directories>]

The -preopts option allows you to send a list of include directories specified with a C Test Script Compiler -INCL option. See the C Test Script Compiler -INCL option.

[-outdir= <output directory>]

This option allows you to specify the target directory for the atlp.

[-accuracy= <time>]

This option expressed the desired accuracy to be used if you are generating a .pts test script for use with System Testing for C, where <time> is expressed in milliseconds (ms).

[-polling= <time>]

This option expressed the desired polling interval to be used if you are generating a .pts test script for use with System Testing for C, where <time> is expressed in milliseconds (ms).

[-studio_log]

This option is for internal usage only.