15.3. tiarmobjdump - Object File Dumper

The tiarmobjdump utility can be used to print the contents of object files and linker output files that are named on the tiarmobjdump command line.

15.3.1. Usage

tiarmobjdump [commands] [options] [filenames …]

  • tiarmobjdump - is the command used to invoke the object file dumper utility.

  • commands - are option-like commands that dictate the tiarmobjdump mode of operation.

  • options - affect the behavior of tiarmobjdump in a particular mode of operation.

  • filenames - identify one or more input object files. If no input file is specified, then tiarmobjdump attempts to read from a.out. If - is used as an input file name, tiarmobjdump processes a file on its standard input stream.

15.3.2. Commands

At least one of the following commands are required, and some commands can be combined with other commands:

-a, --archive-headers

Display the information contained within an archive’s headers.

-d, --disassemble

Disassemble all text sections found in the input files.

-D, --disassemble-all

Disassemble all sections found in the input files.

--disassemble-symbols=<symbol1>[,<symbol2>,...]

Disassemble only the specified <symbolN> arguments. This command will accept demangled C++ symbol names when the --demangle option is specified. Otherwise this command will accept mangled C++ symbol names. The --disassemble-symbols command implies the --disassemble command.

--dwarf=<value>

Dump the specified DWARF debug sections. The supported <value> arguments are:

  • frames - .debug_frame

-f, --file-headers

Display the contents of the overall file header.

--fault-map-section

Display the content of the fault map section.

-h, --headers, --section-headers

Display summaries of the headers for each section.

--help

Display usage information and exit. This command will prevent other commands from executing.

-p, --private-headers

Display format-specific file headers.

-r, --reloc

Display the relocation entries encoded in the input file.

-R, --dynamic-reloc

Display the dynamic relocation entries encoded in the input file.

--raw-clang-ast

Dump the raw binary contents of the clang AST section.

-s, --full-contents

Display the contents of each section.

-t, --syms

Display the symbol table.

-T, --dynamic-syms

Display the contents of the dynamic symbol table.

-u, --unwind-info

Display the unwind information associated with the input file(s).

--version

Display the version of the tiarmobjdump executable. This command will prevent other commands from executing.

-x, --all-headers

Display all available header information. Equivalent to specifying a combination of the following commands:

  • –archive-headers

  • –file-headers

  • –private-headers

  • –reloc

  • –section-headers

  • –syms

15.3.3. Options

The tiarmobjdump utility supports the following options:

--adjust-vma=<offset>

Increase the displayed address in disassembly or section header printing by the specified <offset>.

--arch-name=<string>

Specify the target architecture with a <string> argument when disassembling. Use the --version option for a list of available targets.

-C, --demangle

Demangle C++ symbol names in the output.

--debug-vars=<format>

Print the locations (in registers or memory) of source-level variables alongside disassembly. The <format> argument may be unicode or ascii, defaulting to unicode if omitted.

--debug-vars-indent=<width>

The distance to indent the source-level variable display relative to the start of the disassembly is indicated by the value of the <width> argument. The default value for <width> is 40 characters.

-j, --section=<section1>[,<section2>,...]

Perform commands on the specified sections only.

-l, --line-numbers

When disassembling, display source line numbers. The use of this option implies the use of the --disassemble command.

-M, --disassembler-options=<opt1>[,<opt2>,...]

Pass target-specific disassembler options. Available options are reg-names-std and reg-names-raw.

--mcpu=<cpu-name>

Target a specific CPU with <cpu-name> argument for disassembly. Specify --mcpu=help to display available values for <cpu-name>.

--mattr=<attr1>,+<attr2>,-<attr3>,...

Enable/disable target-specific attributes. Specify --mattr=help to display the available attributes.

--no-leading-addr

When disassembling, do not print leading addresses.

--no-show-raw-insn

When disassembling, do not print the raw bytes of each instruction.

--prefix=<prefix>

When disassembling with the --source option, prepend <prefix> to absolute paths.

--print-imm-hex

Use hex format when printing immediate values in disassembly output.

-S, --source

When disassembling, display source interleaved with the disassembly. Use of this option implies the use of the --disassemble command.

--show-lma

Display the LMA (section load address) column when dumping ELF section headers. By default, this option is disabled unless a section has different VMA (virtual memory address) and LMAs.

--start-address=<address>

When disassembling, only disassemble from the specified <address>.

When printing relocations, only print the relocations patching offsets from at least <address>.

When printing symbols, only print symbols with a value of at least <address>.

--stop-address=<address>

When disassembling, only disassemble up to, but not including the specified <address>.

When printing relocations, only print the relocations patching offsets up to <address>.

When printing symbols, only print symbols with a value up to <address>.

--triple=<string>

Target triple to disassemble for, see description of --version option for a list of available target triple <string> values.

-z, --disassemble-zeroes

Do not skip blocks of zeroes when disassembling.

@<file>

Read command-line options and commands from specified <file>.

15.3.4. Exit Status

tiarmobjdump returns 1 if the command is omitted or is invalid, if it cannot read input files, or if there is a mismatch between their data.

15.3.5. Known Issues

  • tiarmobjdump does not support processing of big-endian object files.

    As an alternative until the fix becomes available, we recommend that the tiarmdis standalone disassembler utility be used to disassemble big-endian object files. The command:

    tiarmdis file.obj file.dis

    Writes the disassembly output from the object file file.o to file.dis. If an output file is not specified, the disassembly output will be written to stdout.