Standard S32DS Create Listing

The Standard S32DS Create Listing page displays the build configuration settings that apply to the Standard S32DS Create Listing virtual tool. This tool calls the listing generator tool to disassemble the application's ELF binary and to generate the disassembly listing for the build target of the current project. The generated .lst file with the project name can be found in the Debug folder of the project.

This page is only available for application projects. To make this page available, enable the Create extended listing option on the Cross Settings page.

Table 1. Application Project Properties: Standard S32DS Create Listing
Setting Description
Command The command pattern for the ${COMMAND} variable. This variable is used in the Command line pattern field (below).

Default: ${cross_prefix}${cross_objdump}${cross_suffix}

The pattern uses the build variables specified on the Cross Settings page.
All options This read-only field shows all flags specified on the General page of the Standard S32DS Create Listing tool settings. The listing generator tool will be called with these flags.

Default flags: --source --all-headers --demangle --line-numbers --wide $(EXECUTABLES)
Command line pattern The command line pattern to run the listing generator tool.

Default: ${COMMAND} ${FLAGS} ${OUTPUT_FLAG} ${OUTPUT_PREFIX}${OUTPUT}

General

The General page configures the general properties of the Standard S32DS Create Listing virtual tool. The tool calls the listing generator tool to generate the LST file with a disassembly of the produced binary artifact.

The following flags configure the listing generator tool to include particular information in the generated disassembly file.

Table 2. Application Project Properties: Standard S32DS Create Listing > General
Setting Description
Display source (--source|-S) Includes the source code intermixed with disassembly.
Display all headers

(--all-headers|-x)

 Shows all available header information, including the symbol table and relocation entries.
Demangle names

(--demangle|-C)

 Makes the disassembled function names more user-friendly and legible by decoding mangling styles used by the compiler.
Display debugging info

(--debugging|-g)

 Includes debugging information obtained from the artifact file.
Note: For the application's ELF file to contain debugging information, configure the compiler to use the STABS or DWARF format. You can do it on the Debugging page of the Standard S32DS C/C++ Compiler tool settings.
Disassemble

(--disassemble|-d)

 Includes assembler mnemonics for the machine instructions from the object file. The tool disassembles only those sections in the ELF file that are expected to contain instructions.
Display file headers

(--file-headers|-f)

 Includes summary information from the overall header of each of the object files.
Display line numbers

(--line-numbers|-l)

 Includes the file name and path, the line numbers corresponding to the object code or relocation entries.

This option requires the Disassemble (--disassemble|-d) or Display relocation info (--reloc|-r) option to be enabled.
Display relocation info

(--reloc|-r)

 Includes entries from the relocation table.
Note: To add disassembly information to the output relocation data, enable the Disassemble (--disassemble|-d) option.
Display symbols (--syms|-t) Includes entries from the symbol table.
Wide lines (--wide|-w) Formats lines for output devices that have more than 80 columns. Use this option to avoid truncation of symbol names.
Other flags Additional options supported by the listing generator (objdump) tool in GCC and not otherwise available on this page. Consult the GCC documentation at gcc.gnu.org.