2.1 Conformance and usage of CMM-style commands

CMM-style commands are a small subset of commands, sufficient for running target initialization scripts. CMM is a scripting language supported by some third-party debuggers.

To execute CMM-style commands you must create a debugger script file containing the CMM-style commands and then use the DS-5 Debugger source command to run the script.

Note:

For full debug support, ARM® recommends that you use the DS-5 Debugger commands. See DS-5 Debugger Commands for more information.

Syntax of CMM-style commands

Many commands accept arguments and flags using the following syntax:

command [argument] [/flag]...

A flag acts as an optional switch and is introduced with a forward slash character. Where a command supports flags, the flags are described as part of the command syntax.

Note:

Commands are not case sensitive. Abbreviations are underlined.

Usage of CMM-style commands

The commands you submit to the debugger must conform to the following rules:

  • Each command line can contain only one debugger command.
  • When referring to symbols, you must use the same case as the source code.

Many commands can be abbreviated. For example, break.set can be abbreviated to b.s. The syntax definition for each command shows how it can be abbreviated by underlining it, for example, break.set.

In the syntax definition of each command:

  • Square brackets [...] enclose optional parameters.
  • Braces {...} enclose required parameters.
  • A vertical pipe | indicates alternatives from which you must choose one.
  • Parameters that can be repeated are followed by an ellipsis (...).

Do not type square brackets, braces, or the vertical pipe. Replace parameters in italics with the value you want. When you supply more than one parameter, use the separator as shown in the syntax definition for each command. If a parameter is a name that includes spaces, enclose it in double quotation marks.

Descriptive comments can be placed either at the end of a command or on a separate line. You can use either // or ; to identify a descriptive comment.

Using expressions with CMM-style commands

Some commands accept expressions. In an expression, you can access the content of registers and variables by using a function-like notation, for example:

print "The result of my expression is: " v.value(myVar)+4+r(R0)

Where v.value() can be used to access the content of a variable and r() can be used to access the content of a register.

Non-ConfidentialPDF file icon PDF versionARM DUI0452Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.