The IAR ELF Dumper—ielfdumparm

In this section:

The IAR ELF Dumper for Arm, ielfdumparm, can be used for creating a text representation of the contents of a relocatable or absolute ELF file.

ielfdumparm can be used in one of three ways:

To produce a listing of the general properties of the input file and the ELF segments and ELF sections it contains. This is the default behavior when no command line options are used.
To also include a textual representation of the contents of each ELF section in the input file. To specify this behavior, use the command line option ‑‑all.
To produce a textual representation of selected ELF sections from the input file. To specify this behavior, use the command line option ‑‑section.

The principal areas that ielfdumparmcan provide information on are:

Target hardware requirements
The ELF version
The application size
The resulting assembler code
Debug symbols

The information can also be retrieved as a machine-readable JSON file. The JSON format contains descriptions of all fields and is recommended if you want more detailed explanations of the output.

Note

To save space in the output, ielfdumparm does not output null values—instead the value will be omitted.

Invocation syntax

The invocation syntax for ielfdumparm is:

ielfdumparm input_file [output_file]

Note

ielfdumparm is a command line tool which is not primarily intended to be used in the IDE.

Parameters

The parameters are:

Parameter	Description
`input_file`	An ELF relocatable or executable file to use as input.
`output_file`	A file or directory where the output is emitted. If absent and no `‑‑output` option is specified, output is directed to the console.

Table 116. ielfdumparm parameters

Summary of ielfdump options

This table summarizes the ielfdumparm command line options:

Command line option	Description
`-a`	Generates output for all sections except string table sections.
`‑‑all`	Generates output for all input sections regardless of their names or numbers.
`‑‑code`	Dumps all sections that contain executable code.
`‑‑disasm_data`	Dumps data sections as code sections.
`-f`	Extends the command line.
`‑‑f`	Extends the command line, optionally with a dependency.
`‑‑json`	Formats the output in JSON format.
`‑‑json_schema`	Generates the JSON schema for output in JSON format.
`‑‑just_json`	Formats the output in JSON format, without implicitly setting other options.
`‑‑no_bom`	Omits the Byte Order Mark from UTF-8 output files.
`‑‑no_error_summary`	Suppresses the error summary after the output.
`‑‑no_header`	Suppresses production of a list header in the output.
`‑‑no_rel_sections`	Suppresses dumping of `.rel`/`.rela` sections.
`‑‑no_strtab`	Suppresses dumping of string table sections.
`‑‑no_utf8_in`	Do not assume UTF-8 for non-IAR ELF files.
`‑‑output, -o`	Specifies an output file.
`‑‑range`	Disassembles only addresses in the specified range.
`‑‑raw`	Uses the generic hexadecimal/ASCII output format for the contents of any selected section, instead of any dedicated output format for that section.
`‑‑raw_io`	Makes `ielfdumparm` generate maximum machine-readable output, without, for example, extra newline characters.
`‑‑section, -s`	Generates output for selected input sections.
`‑‑segment, -g`	Generates output for segments with specified numbers.
`‑‑source`	Includes source with disassembled code in executable files.
`‑‑text_out`	Specifies the encoding for text output files.
`‑‑use_full_std_template_names`	Uses full short full names for some Standard C++ templates.
`‑‑utf8_text_in`	Uses the UTF-8 encoding for text input files.
`‑‑version`	Sends tool output to the console and then exits.

Table 117. ielfdumparm options summary

For more information, see Descriptions of utilities options.

IAR Embedded Workbench for Arm 9.70.x