--text
Prints image information in text format. You can decode an ELF image or ELF object file using this option.
Syntax
--text [options
]
Where
specifies what is displayed, and can be one or more of the
following: options
-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
Disassembly is generated in armasm assembler syntax and not GNU assembler syntax.
Unlike
--disassemble
, the disassembly cannot be used as input to armasm.Note
To disassemble SVE instructions, you must not specify the
--cpu
option. fromelf cannot disassemble Arm®v8.4 instructions without also disassembling Scalable Vector Extension (SVE) instructions. -d
- Prints contents of the data sections.
-e
-
Decodes exception table information for objects. Use with
-c
when disassembling images.Note
Not supported for AArch64 state. -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
is not specified with the
destination
--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