| |||
| Home > DS-5 Debugger commands > DS-5 Debugger commands listed in alphabetical order > break-script | |||
This command assigns a script file to a specific breakpoint. When the breakpoint is triggered then the script is executed.
break-script number [filename]
Where:
numberSpecifies the breakpoint number. This is the number
assigned by the debugger when it is set. You can use info
breakpoints to display the number and status of all breakpoints
and watchpoints.
filenameSpecifies the script file that you want to execute
when the specified breakpoint is triggered. If is
not specified then the currently assigned filename is removed
from the breakpoint.filename
Be aware of the following when using scripts with breakpoints:
You must not assign a script to a breakpoint that has sub-breakpoints. If you do, the debugger attempts to execute the script for each sub-breakpoint. If this happens, an error message is displayed.
Take care with the commands you use in a script that is attached to a breakpoint. For example, if you use the quit command in a script, the debugger disconnects from the target when the breakpoint is hit.
If you put the continue command at the end of a script, this has the same effect as setting the Continue Execution checkbox on the Breakpoint Properties dialog box.