2.3.89. OPTION

Enables you to change the settings of debugger options for this session, or to display their current settings.

Syntax

OPTION [option = value]

where:

option

Specifies a setting from the list:

DEMANDLOAD

A flag that controls when the debugger symbol table is loaded. The value must be one of:

ON

The debug sections of the executable file are loaded into the debugger symbol table as required, speeding up the target load time. This is the default setting.

OFF

The whole symbol table is loaded from the file when the LOAD or RELOAD commands are issued.

ENDIANITY

A flag that indicates the endianness of the target. The value must be one of:

LITTLE

The least significant byte of data is in the lowest address in memory, or appears first in a word in a data stream.

BIG

The most significant byte of data is in the lowest address in memory, or appears last in a word in a data stream.

Use this option to temporarily override the Endianess setting in the Debug Configuration for the target.

The initial value is set on connection, and depends on the type of target:

  • For hardware targets, the value is determined by the equivalent board file setting (Endianess) of the related Debug Configuration.

  • For RVISS targets, the value is determined by the Debug Endian setting you selected for the configured target.

FRAMESTOP

A flag that controls the behavior of the call stack algorithm. The value must be one of:

ON

The call stack stops when a stack frame is encountered that does not have associated debug information. This is the default.

OFF

The call stack stops when the end of stack is reached or when the stack frame no longer makes sense.

PENDMODE

A flag that controls the pending command behavior:

single

Enables you to step, run or execute any pendable command on a processor that is synchronized with a running processor, but is not itself running.

synchronized

Enables you to pend any pendable command on a processor that is synchronized with a running processor, but is not itself running.

RADIX

The number base used for numeric input and output. The value must be one of:

DECIMAL

The default input number base is decimal, base 10, using the digits 0..9. You can also suffix a decimal number with t. This is the default setting.

HEXADECIMAL

The default input number base is hexadecimal, base 16, using the digits 0..9 and a..f, or 0..9 and A..F. You can also prefix a hexadecimal number with 0x or suffix it with h.

Note

It is suggested that you use either the 0x prefix or h suffix for every hexadecimal number. This ensures that the value is valid if you change the radix to decimal. For example, 0x80FF is always valid, but 80FF is invalid for a decimal radix.

Also, if you use the h suffix, it is suggested that you prefix the hexadecimal number with a zero digit to avoid confusion with symbol names, for example, 0FADEh.

OUTDEC

The output number base is decimal, base 10, using the digits 0..9. This is the default setting.

OUTHEX

The output number base is hexadecimal, base 16, is prefixed with 0x and uses the digits 0..9 and A..F.

The number base for a particular session can also be set in the workspace options.

STEPPING

A flag that controls the high-level stepping behavior.

In the Disassembly tab, lines of interleaved source in the disassembly view are prefixed by either >>> or ---. This flag determines whether lines prefixed with --- are stepped to or stepped over.

The value must be one of:

ALL

Step to the first instruction of the next line of source prefixed with >>> or ---.

STATEMENT

Step to the first instruction of the next line of source prefixed by >>>. That is, step over any lines of source prefixed with ---. This is the default.

value

Defines the value that you want to assign to the specified option.

Description

The OPTION command enables you to change the settings of debugger options for this session, or to display their current settings. If you supply no parameters, the command displays the current settings of various options.

Examples

option

Displays the current option settings, for example:

DEMANDLOAD = ON
ENDIANITY = LITTLE
FRAMESTOP = OFF
RADIX = DECIMAL, OUTHEX
STEPPING = STATEMENT
PENDMODE = SINGLE
option radix=hex

The numerical input base is hexadecimal. The following are valid numbers when the default number base is hexadecimal:

  • 0xAB (AB hex, 171 decimal)

  • 0AB (AB hex, 171 decimal)

  • 45 (45 hex, 69 decimal)

  • 45t (45 decimal)

  • 45H (45 hex, 69 decimal).

and the following are not valid:

  • AB (does not start with a digit)

  • 0t45 (t must be at the end).

The following example opens a user-defined window with the name User80 followed by a window named User50:

> option radix=hex
> vopen 50
> option radix=dec
> vopen 50

See also

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0175K
Non-Confidential