RealView® Debugger Command Line Reference GuideVersion 3.1
Home > RealView Debugger Commands > Alphabetical command reference > SETTINGS

2.3.118. SETTINGS

The SETTINGS command enables you to define target settings.

Syntax

SETTINGS [{default | option_list}]

where:

default

Causes all settings to revert to their default values.

option_list

A list of option names and values. Each option-value pair consists of a setting name, an equals sign, and a value. The available option names and values are described in List of options.

You can specify multiple options in the list by separating each option-value pair with a colon.

Description

The SETTINGS command enables you to define settings (properties) for target support. Some of these options have equivalent settings in the Workspace of the GUI. See the individual option description in List of options for the equivalent GUI setting.

Note

If you want to change other Workspace settings, you must use the GUI.

If the only parameter is the default qualifier, then all the settings revert to their default values. If you supply no parameters, the command displays the current values of settings for which a default value is defined.

Each setting is defined in the form of name=value, and multiple settings can be changed using a colon (:) as a separator.

List of options

The standard option names are:

loadact={default|noimask|reset|pre_reset}

Action on load:

default

Normal load image behavior. For ARM processors, the processor is placed in ARM state and supervisor mode with interrupts disabled.

noimask

Do not change the processor status register. For example, on ARM processors, the default modification of CPSR is not performed.

reset

Reset the processor after the load, to perform a start from reset.

pre_reset

Reset the processor before the load.

restart={set_pc|reload|reload_data}

Defines the action of the RESTART command. The possible values are:

set_pc

Set the PC to the entry point of the image.

reload

Reload the image as for RELOAD. The options relating to RELOAD, that is loadact and pcset, also apply.

reload_data

Reload only the initialized data of the image. The option relating to RELOAD, that is loadact, also applies.

restart_reset={True|False}

Reset on restart:

True

Reset the processor on RESTART, in addition to any other actions.

False

Do not reset the processor on RESTART.

fillstack=value

Define a value to fill stack memory with before the program starts. This is not used for ARM processor image files.

fillheap=value

Define a value to fill memory defined as heap. This is not used for ARM processor image files.

fillundefined=value

Define a value to fill unused words of memory, such as words between each section of the image in memory. This is not used for ARM processor image files.

imagecache_enabled={True|False}

The image cache stores debug information from the image rather than from physical memory. This enables RealView Debugger to access the debug information if it cannot access the physical memory, for example, when the target is running. This is especially important when tracing, so that you do not have to stop the target for RealView Debugger to collect or decompress trace information.

However, you might want to disable image caching if, for example, you have self-modifying code, which can lead to incorrect information being displayed.

Also, if the image cache is disabled, you cannot view the disassembly of your image when the target is running.

Enables and disables the image cache:

True

Enables the image cache.

False

Disables the image cache. This is the default.

Note

Image caching is enabled by default.

disasm={default|standard|alternate|bytecode|extended}

Set the disassembly mode. This affects the Disassembly tab, and the output from the PRINTDSM command.

The possible values are:

default

Attempt to auto-detect the disassembly mode.

For ARM architecture processors, select from ARM, Thumb, Jazelle bytecodes, or Thumb-2EE, using information from the image file where available.

standard

Select the standard instruction disassembly mode.

For ARM architecture processors, select ARM state (32-bit) instructions.

alternate

Select the alternate instruction disassembly mode.

For ARM architecture processors, select Thumb state (16-bit) instructions.

bytecode

Select the Jazelle bytecode disassembly mode. This is available only for ARM processors.

extended

Select the Thumb-2EE disassembly mode. This is available only for ARM processors.

Equivalent Workspace setting: DEBUGGER, Disassembler, Format.

dsmvalue={True|False}

Selects whether the instruction code is displayed in disassembly listings. The possible values are:

True

Disassembly listings include the instruction opcode, along with the instruction memory address and mnemonics.

False

Disassembly listings do not include the instruction opcode.

Equivalent Workspace setting: DEBUGGER, Disassembler, Instr_value.

Additional options might be implemented for a particular Debug Interface. See the documentation of your Debug Interface for more information.

Alias

PROPERTIES is an alias of SETTINGS.

Examples

The following examples show how to use SETTINGS:

settings loadact=reset

After an image is loaded or reloaded, reset the processor (in hardware). This is useful when the image has been constructed to run from target reset.

settings disasm=standard:dsmvalue=true

Specifies that disassembly is to be displayed using the standard format for the target, and that the instruction code is to be hidden from the disassembly listings.

See also

Copyright © 2002-2007 ARM Limited. All rights reserved.ARM DUI 0175I
Non-Confidential
PDF file icon  PDF version
Home > RealView Debugger Commands > Alphabetical command reference > SETTINGS