ARM Compiler v5.06 for µVision fromelf User Guide : 3.46 --text

3.46 --text

Prints image information in text format. You can decode an ELF image or ELF object file using this option.

Syntax

--text [options]

Where options specifies what is displayed, and can be one or more of the following:

-a: Prints the global and static data addresses (including addresses for structure and union contents).

This option can only be used on files containing debug information. If no debug information is present, a warning is displayed.

Use the --select option to output a subset of fields in a data structure.

If you want to view the data addresses of arrays, expanded both inside and outside structures, use the --expandarrays option with this text category.
-c: This option disassembles code, alongside a dump of the original binary data being disassembled and the addresses of the instructions.

Note

The disassembly cannot be input to the assembler.
-d: Prints contents of the data sections.
-e: Decodes exception table information for objects. Use with -c when disassembling images.
-g: Prints debug information.
-r: Prints relocation information.
-s: Prints the symbol and versioning tables.
-t: Prints the string tables.
-v: Prints detailed information on each segment and section header of the image.
-w: Eliminates line wrapping.
-y: Prints dynamic segment contents.
-z: Prints the code and data sizes.

These options are only recognized in text mode.

Usage

If you do not specify a code output format, --text is assumed. That is, you can specify one or more options without having to specify --text. For example, fromelf -a is the same as fromelf --text -a.

If you specify a code output format, such as --bin, then any --text options are ignored.

If destination is not specified with the --output option, or --output is not specified, the information is displayed on stdout.

Use the --only option to filter the list of sections.

Examples

The following examples show how to use --text:

To produce a plain text output file that contains the disassembled version of an ELF image and the symbol table, enter:
```
fromelf --text -c -s --output=outfile.lst infile.axf
```
To list to stdout all the global and static data variables and all the structure field addresses, enter:
```
fromelf -a --select=* infile.axf
```
To produce a text file containing all of the structure addresses in infile.axf but none of the global or static data variable information, enter:
```
fromelf --text -a --select=*.* --output=structaddress.txt infile.axf
```
To produce a text file containing addresses of the nested structures only, enter:
```
fromelf --text -a --select=*.*.* --output=structaddress.txt infile.axf
```
To produce a text file containing all of the global or static data variable information in infile.axf but none of the structure addresses, enter:
```
fromelf --text -a --select=*,~*.* --output=structaddress.txt infile.axf
```
To output only the .symtab section information in infile.axf, enter:
```
fromelf --only .symtab -s --output=symtab.txt infile.axf
```