| |||
| Home > DS-5 Debugger commands > DS-5 Debugger commands listed in alphabetical order > tbreak | |||
This command sets an execution breakpoint at a specific location
and subsequently deletes it when the breakpoint is hit. You can
also specify a conditional breakpoint by using an if statement
that stops only when the conditional expression evaluates to true.
Breakpoints that are set within a shared object are deleted when the shared object is unloaded.
Use set breakpoint to control the automatic
breakpoint behavior when using this command.
tbreak [-d] [-p] [ [filename:]location | *address] [ thread | core number...] [if expression]
Where:
dDisables the breakpoint immediately after creation.
pSpecifies whether or not the resolution of an unrecognized breakpoint location results in a pending breakpoint being created.
filenameSpecifies the file.
locationSpecifies the location:
line_numis a line number
functionis a function name.
labelis a label name.
+offset | -offsetSpecifies the line offset from the current location.
addressSpecifies the address. This can be either an address or an expression that evaluates to an address.
numberSpecifies one or more threads or processors to apply
the breakpoint to. You can use $thread to refer
to the current thread. If is
not specified then all threads are affected.number
expressionSpecifies an expression that is evaluated when the breakpoint is hit.
If no arguments are specified then a breakpoint is set at the current PC.
Example 151. tbreak
tbreak *0x8000 # Set breakpoint at address 0x8000 tbreak *0x8000 thread $thread # Set breakpoint at address 0x8000 on # current thread tbreak *0x8000 thread 1 3 # Set breakpoint at address 0x8000 on # threads 1 and 3 tbreak main # Set breakpoint at address of main() tbreak SVC_Handler # Set breakpoint at address of label SVC_Handler tbreak +1 # Set breakpoint at address of next source line tbreak my_File.c:main # Set breakpoint at address of main() in my_File.c tbreak my_File.c:8 # Set breakpoint at address of line 8 in my_File.c tbreak function1 if x>0 # Set conditional breakpoint that stops when x>0