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

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.

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.

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.

Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0452J
Non-ConfidentialID051612