Configure and run MB trace.
Syntax
mbtrace [options]
Configure and run MB program and event trace for tracing the application running on MB. The output is the disassembly of the executed program.
Options
Option | Description |
---|---|
-start
|
Enable and start trace. After starting trace the execution of the program is captured for later output. |
-stop
|
Stop and output trace. |
-con
|
Output trace after resuming execution of active target until a breakpoint is hit. At least one breakpoint or watchpoint must be set to use this option. This option is only available with embedded trace. |
-stp
|
Output trace after resuming execution of the active target until control reaches instruction that belongs to different line of source code. |
-nxt
|
Output trace after resuming execution of the active target until control reaches instruction that belongs to a different line of source code, but runs any functions called at full speed. |
-out <filename>
|
Output trace data to a file. <filename> Name of the output file for writing the trace data. If not specified, data is output to standard output. |
-level <level>
|
Set the trace level to "full", "flow", "event", or "cycles". If not specified, "flow" is used. |
-halt
|
Set to halt program execution when the trace buffer is full. If not specified, trace is stopped but program execution continues. |
-save
|
Set to enable capture of load and get instruction new data value. |
-low <addr>
|
Set low address of the external trace buffer address range. The address range must indicate an unused accessible memory space. Only used with external trace. |
-high <addr>
|
Set high address of the external trace buffer address range. The address range must indicate an unused accessible memory space. Only used with external trace. |
-format <format>
|
Set external trace data format to "mdm", "ftm", or "tpiu". If format is not specified, "mdm" is used. The "ftm" and "tpiu" formats are output by Zynq 7000 PS. Only used with external trace. |
Returns
Depends on options used. -start, -out, -level, -halt -save, -low, -high, -format Returns nothing on successful configuration. Error string, in case of error.
-stop, -con, -stp, -nxt
: Returns nothing, and outputs trace data to a file or standard output. Error string, in case of error.
Examples
mbtrace -start
Enable and start trace.
mbtrace -start -level full -halt
Enable and start trace, configuring to save complete trace instead of only program flow and to halt execution when trace buffer is full.
mbtrace -stop
Stop trace and output data to standard output.
mbtrace -stop -out trace.out
Stop trace and output data to trace.out.
mbtrace -con -out trace.out
Continue execution and output data to trace.out.