Runtime Tracing settings

The Runtime Tracing Control settings are part of the Runtime Analysis node of the Configuration Settings dialog box, which allows you to configure settings for each node.

By default, the settings of each node are inherited from those of the parent node. When you override the settings of a parent node, changes are propagated to all child nodes within the same Configuration. Overridden fields are displayed in bold.

Instrumentation Control

  • Runtime Tracing file name (.tdf): This allows you to force a filename and path for the dynamic .tdf file. By default, the .tdf carries the name of the application node.

  • Show unnamed classes: For C++ only. When this option is disabled, unnamed class are not instrumented.

  • Show data classes: When this option is disabled, structures or classes that do not contain methods are excluded from instrumentation. Disable this option to reduce instrumentation overhead.

  • Display one note for class templates: For C++ only. With this option, the UML/SD Viewer will not display notes for each instance of template classes.

  • Display return functions as sequence: For C only. With this option, the UML/SD Viewer displays calls located in return expressions as if they were executed sequentially and not in a nested manner.

Trace Control

  • Split trace file: See Splitting trace files for more information on this setting.

  • Maximum size (Kbytes): This specifies the maximum size for a split .tdf file. When this size is reached, a new split .tdf file is created.

  • File name prefix: By default, split files are named as att_ <number> .tdf, where <number> is a 4-digit sequence number. This setting allows you to replace the att_ prefix with the prefix of your choice.

  • Automatic loop detection: Loop detection simplifies UML sequence diagrams by summarizing repeating traces into a loop symbol. Loops are an extension to the UML sequence diagram standard and are not supported by UML.

  • Additional options: This setting allows you to add command line options. Normally, this line should be left blank.

  • Display maximum call level: When selected, the Target Deployment Port records the highest level attained by the call stack during the trace. This information is displayed at the end of the UML Sequence Diagram in the UML/SD Viewer as Maximum Calling Level Reached.

Runtime options

These settings allow you to set compilation flags that define how the Runtime Tracing feature interacts with the Target Deployment Port. These are general settings for the Target Deployment Port.

  • Disable on-the-fly mode: When selected, this setting stops on-the-fly updating of the dynamic .tdf file. This option is primarily for Target Deployment Ports that use printf output.

  • Runtime tracing buffer and Partial Runtime Tracing flush: Please see Trace Item Buffer and Partial Trace Flush for more information about these settings.

  • M aximum buffer size (events): Maximum number of events recorded in the buffer before it is flushed.

  • User signal action: Specify an action to be performed when a user signal is detected: No action, Flush call stack, Runtime Tracing on/off

  • Record and display time stamp: This setting adds time stamp information to each element in the UML sequence diagram generated by Runtime Tracing.

  • Record and display heap size: This setting enables the Heap Size Bar in the UML sequence diagram produced by Runtime Tracing.

  • Record and display thread info: This setting enables the Thread Bar in the UML sequence diagram produced by Runtime Tracing.

To edit the Runtime Tracing settings for one or several nodes:

  1. In the Project Explorer, click the Settings button.

  2. Select a node in the Project Explorer pane.

  3. Select the Runtime Analysis node and the Runtime Tracing node.

  4. In the Configuration Settings list, select Instrumentation Control, Trace Control or Target Deployment Port Settings.

  5. When you have finished, click OK to validate the changes.

Related Topics

About Configuration Settings | Multi-Thread Support | Partial Trace Flush | Trace Item Buffer | Splitting Trace Files