1.1.1 Syntax

DS-5 Debugger commands accept arguments and flags. 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.

command [argument] [/flag]...

Note:

  • Commands are not case sensitive.

  • Abbreviations are underlined.

  • When you specify an address as an argument to a command, you can also specify the address space prefix, for example N:0x80000000. If you do not specify the address space, DS-5 Debugger assumes the current address space.

In commands that use /flag, the position of /flag should generally be as shown in the command syntax. 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.

You can execute the commands by entering them in the debugger command-line console or by running debugger script files. Alternatively in Eclipse, you can open the DS-5 Debug perspective where you can use the menus, icons, and toolbars provided or you can enter DS-5 Debugger commands in the Commands view.

The debugger requires enough letters to uniquely identify the command you enter. Many commands have alternative names, or aliases, that you might find easier to remember. For example, backtrace and where are aliases for the info stack command.

Some command names and aliases can be abbreviated. For example, info stack can be abbreviated to i s. The syntax definition for each command shows how it can be abbreviated by underlining it for example, info stack.

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 the # character to identify a descriptive comment.

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