1.3.8 break-script

Assigns a script file to a specific breakpoint. The script executes when the breakpoint is triggered.

Syntax

break-script number [filename]

Where:

number

Specifies 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.

filename

Specifies the script file that you want to execute when the specified breakpoint is triggered. If filename is not specified then the currently assigned filename is removed from the breakpoint.

Usage

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 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.

Example 1-11 Examples

break-script 1 myScript.ds      # Run myScript.ds when breakpoint 1 is triggered
Non-ConfidentialPDF file icon PDF versionARM DUI0452Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.