xSCOPE command line options#

In order to use xSCOPE, the various tools need to be configured to make use of it. This section links to the relevant chapters which are required.

xcc options#

To enable xSCOPE support when using xcc, one of the following methods must be used:

Use xcc -fxscope for every xcc call

Pass an xSCOPE configuration file to every xcc call.

Note that to enable xSCOPE, support must be indicated in the target’s xn file. See XN specification for more information.

xrun options#

These options can be supplied to xrun. Note that if a program is compiled with xSCOPE support, xSCOPE support must also be enabled when using xrun. If probes or records are being used, then either xrun --xscope-file or option:xrun –xscope-port must be provided for those records to be recorded.

Attempting to use any xSCOPE argument on a program that has not been compiled with xSCOPE support will fail.

Table 40 xrun options#
Option	Translated to xgdbserver
`xrun --xscope`	`--xscope`
`xrun --xscope-io-only`	`--xscope-limit 0`
`xrun --xscope-limit`	`--xscope-limit arg`
`xrun --xscope-file`	`--xscope-file arg`
`xrun --xscope-port`	`--xscope-port-blocking --xscope-port ip:port`

Supplying any of these xSCOPE options will automatically imply --xscope.

xgdbserver options#

These options can be supplied either to the xgdb connect or attach command, or xgdbserver directly.

Table 41 xgdbserver options#
Option	Short description
`xgdbserver --xscope`	Connect to the target with xSCOPE for io and data collection.
`xgdbserver --xscope-limit`	Limit the number of (non-ID) xSCOPE records which will be processed.
`xgdbserver --xscope-file`	Send xSCOPE data entries to a file.
`xgdbserver --xscope-port`	Start a local xSCOPE server at the provided port, which will serve xSCOPE messages.
`xgdbserver --xscope-port-blocking`	Wait for a connection to the –xscope-port xSCOPE server to be made before completing initialisation of xgdbserver.

Supplying any of these xSCOPE options will automatically imply --xscope.