Controlling DWARF Debug Information

The following command-line options control what form of debug information, if any, is generated by the compiler and is propagated to a linked executable file.

armcl Option (and alias) tiarmclang Option
–symdebug:dwarf (-g) -g

The -g option causes both the armcl and tiarmclang compilers generate debug information for a compilation unit in accordance with the DWARF standard. When the -g option is specified, the armcl compiler generates DWARF version 3 debug information by default. The tiarmclang compiler also generates DWARF version 3 debug information by default when the -g option is specified on the compiler command-line.

However, please note that in the tiarmclang 1.0.0+sts compiler tools, the use of -gdwarf-4 may introduce debug information discontinuities with the CCS debugger. It is recommended that until these issues are addressed that you should use -gdwarf-3 for debugging.

armcl Option tiarmclang Option
–symdebug:dwarf_version=<version> -gdwarf-<version> -gdwarf-3 -gdwarf-4

The armcl compiler provides the –symdebug:dwarf_version option to allow you to select between generating DWARF version 3 (the default) or DWARF version 4 debug information.

The tiarmclang compiler provides the analogous -gdwarf-<version> option, allowing you to select between DWARF versions 2, 3 (the tiarmclang default), or 4.

Please note that in the tiarmclang 1.0.0+sts compiler tools, the use of -gdwarf-4 may introduce debug information discontinuities with the CCS debugger. It is recommended that until these issues are addressed that you should use -gdwarf-3 for debugging.

armcl Option (and alias) tiarmclang Option
–symdebug:none (default)

Even if the -g option is not specified on the command-line, the armcl compiler still generates DWARF version 3 debug information by default. The armcl compiler’s –symdebug:none option allows you to instruct the compiler to avoid generating any debug information for a compilation unit.

The default behavior for the tiarmclang compiler is to not generate any DWARF debug information unless the -g or one of the -gdwarf-<version> options are specified on the tiarmclang command-line.