Partial trace flush

Runtime Tracing for C, C++

When using this mode, the Target Deployment Port only sends messages related to instance creation and destruction, or user notes. All other events are ignored. This can be useful to reduce the output of trace.

When Partial Trace Flush mode is enabled, message dump can be toggled on and off during trace execution.

The Partial Trace Flush settings are located in the Runtime Tracing Settings.

To enable Partial Trace Flush from the Node Settings:

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

  2. Select one or several nodes in the Configuration pane.

  3. Select Runtime Analysis > Runtime Tracing > Runtime options.

  4. Set the Partial Runtime Tracing flush setting to Yes or No to activate or disable the mode.

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

To toggle message dump from within the source code:

  1. To do this, use the Runtime Tracing pragma user directives:

    • _ATT_START_DUMP

    • _ATT_STOP_DUMP

    • _ATT_TOGGLE_DUMP

    • _ATT_DUMP_STACK

See the Reference Manual for more information about pragma directives.

To control message dump through a user signal (native UNIX only):

This capability is available only when using a native UNIX target platform.

Under UNIX, the kill command allows you to send a user signal to a process. Runtime Tracing can use this signal to toggle message dump on and off.

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

  2. Select one or several nodes in the Configuration pane.

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

  4. Select Runtime Tracing Control.

  5. Set the Partial Runtime Tracing flush setting to Yes or No to activate or disable the mode.

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

Note By default, the expected signal is SIGUSR1, but you can change this by setting the ATT_SIGNAL_DUMP environment variable to the desired signal number. See the Reference Manual for more information about environment variables.

Related Topics

Runtime Tracing Control Settings