objdump - LLVM’s object file dumper — LLVM 21.0.0git documentation (original) (raw)

SYNOPSIS¶

llvm-objdump [_commands_] [_options_] [_filenames…_]

DESCRIPTION¶

The llvm-objdump utility prints the contents of object files and final linked images named on the command line. If no file name is specified,llvm-objdump will attempt to read from a.out. If - is used as a file name, llvm-objdump will process a file on its standard input stream.

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 executable sections found in the input files. On some architectures (AArch64, PowerPC, x86), all known instructions are disassembled by default. On the others, --mcpu or --mattr is needed to enable some instruction sets. Disabled instructions are displayed as<unknown>.

-D, --disassemble-all¶

Disassemble all sections found in the input files.

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

Disassemble only the specified symbols. Takes demangled symbol names when--demangle is specified, otherwise takes mangled symbol names. Implies --disassemble.

--dwarf=¶

Dump the specified DWARF debug sections. The supported values 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. Does not stack with other commands.

-p, --private-headers¶

Display format-specific file headers.

-r, --reloc¶

Display the relocation entries in the file.

-R, --dynamic-reloc¶

Display the dynamic relocation entries in the 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 info of the input(s).

This operation is only currently supported for COFF and Mach-O object files.

-v, --version¶

Display the version of the llvm-objdump executable. Does not stack with other commands.

-x, --all-headers¶

Display all available header information. Equivalent to specifying--archive-headers, --file-headers,--private-headers, --reloc, --section-headers, and --syms.

OPTIONS¶

llvm-objdump supports the following options:

--adjust-vma=¶

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

--arch-name=¶

Specify the target architecture when disassembling. Use --versionfor a list of available targets.

--build-id=¶

Look up the object using the given build ID, specified as a hexadecimal string. The found object is handled as if it were an input filename.

-C, --demangle¶

Demangle symbol names in the output.

--debug-file-directory ¶

Provide a path to a directory with a .build-id subdirectory to search for debug information for stripped binaries. Multiple instances of this argument are searched in the order given.

--debuginfod, --no-debuginfod¶

Whether or not to try debuginfod lookups for debug binaries. Unless specified, debuginfod is only enabled if libcurl was compiled in (LLVM_ENABLE_CURL) and at least one server URL was provided by the environment variableDEBUGINFOD_URLS.

--debug-vars=¶

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

--debug-vars-indent=¶

Distance to indent the source-level variable display, relative to the start of the disassembly. Defaults to 52 characters.

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

Perform commands on the specified sections only. For Mach-O usesegment,section to specify the section name.

-l, --line-numbers¶

When disassembling, display source line numbers. Implies--disassemble.

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

Pass target-specific disassembler options. Available options:

• reg-names-std: ARM only (default). Print in ARM ‘s instruction set documentation, with r13/r14/r15 replaced by sp/lr/pc.
• reg-names-raw: ARM only. Use r followed by the register number.
• no-aliases: AArch64 and RISC-V only. Print raw instruction mnemonic instead of pseudo instruction mnemonic.
• numeric: RISC-V only. Print raw register names instead of ABI mnemonic. (e.g. print x1 instead of ra)
• att: x86 only (default). Print in the AT&T syntax.
• intel: x86 only. Print in the intel syntax.

--disassembler-color=¶

Enable or disable disassembler color output.

• off: Disable disassembler color output.
• on: Enable disassembler color output.
• terminal: Enable disassembler color output if the terminal supports it (default).

--mcpu=¶

Target a specific CPU type for disassembly. Specify --mcpu=help to display available CPUs.

--mattr=<a1,+a2,-a3,...>¶

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

-mllvm ¶

Specify an argument to forward to LLVM’s CommandLine library.

--no-leading-addr, --no-addresses¶

When disassembling, do not print leading addresses for instructions or inline relocations.

--no-print-imm-hex¶

Do not use hex format for immediate values in disassembly output.

--no-show-raw-insn¶

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

--offloading¶

Display the content of the LLVM offloading section.

--prefix=¶

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

--prefix-strip=¶

When disassembling with the --source option, strip out levelinitial directories from absolute paths. This option has no effect without--prefix.

--print-imm-hex¶

Use hex format when printing immediate values in disassembly output (default).

-S, --source¶

When disassembling, display source interleaved with the disassembly. Implies--disassemble.

--show-all-symbols¶

Show all symbols during disassembly, even if multiple symbols are defined at the same location.

--show-lma¶

Display the LMA column when dumping ELF section headers. Defaults to off unless any section has different VMA and LMAs.

--start-address=