debug (Linux*)

Specifies settings that enhance debugging.

IDE Equivalent

None

Architectures

IA-32, IntelŪ EM64T, IntelŪ ItaniumŪ architecture

Syntax

Linux: -debug keyword
Windows:  See debug (Windows*)

Arguments

keyword     Is an option for enhanced debugging. Possible values are:
  [no]inline_debug_info Determines whether enhanced debug information is produced for inlined code.
  [no]semantic_stepping Determines whether enhanced debug information useful for breakpoints and stepping is produced.
  [no]variable_locations Determines whether enhanced debug information useful in finding scalar local variables is produced.
  extended Enables all the other debug options.

Default

OFF No enhanced debugging information is produced.

Description

This option specifies settings that enhance debugging.

To use this option, you must also specify the -g option.

Option

Description

-debug inline_debug_info Produces enhanced debug information for inlined code.
It provides more information to debuggers for function call traceback. The IntelŪ Debugger (IDB) has been enhanced to use richer debug information to show simulated call frames for inlined functions.
-debug semantic_stepping Produces enhanced debug information useful for breakpoints and stepping.
It tells the debugger to stop only at machine instructions that achieve the final effect of a source statement. For example, in the case of an assignment statement, this might be a store instruction that assigns a value to a program variable; for a function call, it might be the machine instruction that executes the call. Other instructions generated for those source statements are not displayed during stepping.
-debug variable_locations Produces enhanced debug information useful in finding scalar local variables.
It uses a feature of the Dwarf object module known as "location lists". This feature allows the run-time locations of local scalar variables to be specified more accurately; that is, whether, at a given position in the code, a variable value is found in memory or a machine register. The Intel Debugger (IDB) is able to process location lists and display local variable values with greater accuracy at run-time.
-debug extended Sets the debug options: inline_debug_info, semantic_stepping, and variable_locations.

Alternate Options

-debug inline_debug_info Linux: -inline-debug-info
Windows: None

See Also

Building Applications: Debugging Overview