SET OPTION

Set global debugger flags.

Syntax

SETOPTION/ASMCENTER=ON | OFF

SETOPTION/ASMLABEL=ON | OFF

SETOPTION/ASMSOURCE=FILE | LINE | NONE

SET OPTION /ASMSTYLE= INTEL | ATT

SET OPTION /ATADDR= ON | OFF

SET OPTION /EVALUATE= DEFAULT | BINARY | DEC | OCTAL | HEX

SET OPTION /EVPATH= ON | OFF

SET OPTION /HARD= ON | OFF

SET OPTION /MALIGN= BYTE | WORD |LONG | LONGLONG | DEFAULT

SET OPTION /MCACHE= ON | OFF

SET OPTION /NOPATH= ON | OFF

SET OPTION /NOWAIT= ON | OFF

SET OPTION /POINTER= ASCII | HEX

SET OPTION /PROTOTYPE= ON | OFF

SET OPTION /RUNAFTERRESTART= ON | OFF

SET OPTION /SORT= CASE | NOCASE

SET OPTION /SYMBOL= NONE | PREDOT | PREVIOUS | POST

SET OPTION /SYMUPPER= ON | OFF

Parameters

/ASMCENTER= ON | OFF

Centers the contents of the Assembler window around the current value of the instruction pointer.

Note

The option causes memory reads at addresses lower than the actual value of EIP/RIP. This could produce invalid memory reads and target crashes. To avoid this behavior, set the option to OFF.

/ASMLABEL= ON | OFF

Turns the display of assembler symbols in the Assembler window on or off. The default value is ON.

/ASMSOURCE= FILE | LINE | NONE

Specifies how the source code annotations will be interleaved with the disassembly in the Assembler window:

If ASMSOURCE= NONE is set, no source code annotations are added and only the disassembly is shown in the Assembler window.

If ASMSOURCE= LINE is set, the disassembly is interleaved with the source code. Only those source lines translated into assembler code are displayed.

If ASMSOURCE= FILE is set, the disassembly is interleaved with the full source code.

/ASMSTYLE= INTEL | ATT

If set to ASMSTYLE= INTEL, the Intel disassembly syntax is used.

If set to ASMSTYLE= ATT, the AT&T disassembly syntax is used.

This option is set to INTEL by default.

/ATADDR= ON | OFF

Enables or disables the additional display of symbol addresses in the Source window's tooltip or in the Console window using the EVALUATE command. For example:

SET OPTION /ATADDR= ON

EVALUATE var1

displays

var1 [ at address 0x00040000 ]: 3

in the Console window.

This option is set to ON by default.

/EVALUATE= DEFAULT | BINARY | DEC | OCTAL | HEX

Sets the default display mode for evaluations. If this option is set to DEFAULT, expressions are evaluated as they are defined by default. This option is set to DEFAULT by default.

/EVPATH= ON | OFF

Enables or disables the additional display of the symbol path in the Console window when the symbol is evaluated using the EVALUATE command. For example:

SET OPTION /EVPATH= ON

EVALUATE helloMain

displays

helloMain [ at address 0xA007F8D8 ] : 0xA011B11C = "main module (crm.c)" [crm_cpp\main(void)\helloMain]

in the Console window.

This option is set to ON by default.

/HARD= ON | OFF

If set to ON, only hardware breakpoints are used. The default is OFF.

/MALIGN= BYTE | WORD | LONG | LONGLONG | DEFAULT

Specifies the memory access method. If set to DEFAULT, the debugger selects the alignment which provides the best performance for the connected target.

/MCACHE= ON | OFF

Enables or disables the debugger to cache memory read accesses sent to the target. Caching can improve the debugger's performance, because it decreases the number of target memory read accesses the debugger has to establish. The default is ON.

/NOPATH= ON | OFF

The compiler writes the path of the source files into the debug information. If this parameter is set to ON, this information is not used; the debugger searches for the source files in the working directory and the source directories if they are specified by the -D option. The default is OFF.

/NOWAIT= ON | OFF

If this option is set to OFF, the debugger executes the command until the command has been finished and the target stops. For example, during a run, no further commands can be entered in the Console window. If this option is set to ON, commands may be entered during the target is running. The command line changes to XDB_R> indicating that the target is running. This option is set to ON by default.

/POINTER= ASCII | HEX

If this option is set to ASCII and a character pointer is referenced, the result will be displayed as a ASCII character string. If this option is set to HEX, only the hexadecimal value of the pointer is displayed. This option is set to ASCII by default.

/PROTOTYPE= ON | OFF

If this option is set to ON, prototypes are displayed when a C++ module is loaded. This option set to OFF by default.

/RUNAFTERRESTART= ON | OFF

When you click the Reset Target button or issue the RESTART command, and this option is set to ON, the target will immediately execute instructions after restarting and finishing the reset sequence. If the option is set to OFF, the target will stop the execution at the reset vector after a restart.

/SORT= CASE | NOCASE

With this option the sort mechanism for the source modules in the Modules window and for the list windows may be switched between case-sensitive and not case-insensitive. For example, if SORT = CASE is set, all elements in the Modules window are sorted in the following order: A-Z, a-z.

The default is set to NOCASE.

/SYMBOL=mode

The following values for mode are available:

NONE

POST

PRE

PREDOT

These parameters are used to define whether symbol names have been built by the compiler with an underscore or dot added. For example, a procedure named init may be called init, _init, init_, or .init.

NONE defines no underscore

POST defines an underscore at the end

PRE defines an underscore in front

PREDOT defines a dot in front

/SYMUPPER= ON | OFF

If set to ON, symbols are converted to upper case. The debugger does not distinguish between symbols written in lower or upper case. The default is OFF.

Description

This command sets global debugger flags.

Example

SET OPTION /ASSEMBLER = ON
SET OPTION /ASMLABEL = OFF
SET OPTION /ASMSOURCE = FILE
SET OPTION /ASMSTYLE = INTEL
SET OPTION /AUTOLOAD = OFF
SET OPTION /BREAKPOINT = NOLOAD
SET OPTION /EVALUATE = HEX
SET OPTION /EVWINDOW = MULTIPLE
SET OPTION /HARD = ON
SET OPTION /MARKCODE = ON
SET OPTION /MARKSP = ON
SET OPTION /MEMORY = LONG
SET OPTION /NOPATH = ON
SET OPTION /NOWAIT = OFF
SET OPTION /POINTER = HEX
SET OPTION /PROTOTYPE = ON
SET OPTION /SORT = CASE
SET OPTION /SYMBOL = PREDOT
SET OPTION /SYMUPPER = ON

See Also

For more complete information about compiler optimizations, see our Optimization Notice.