xref: /freebsd/usr.bin/clang/llvm-objdump/llvm-objdump.1 (revision 19261079b74319502c6ffa1249920079f0f69a72)
$FreeBSD$
Man page generated from reStructuredText.
. . .nr rst2man-indent-level 0 . \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .rstReportMargin pre:
. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
"LLVM-OBJDUMP" "1" "2021-06-07" "12" "LLVM"
NAME
llvm-objdump - LLVM's object file dumper
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: NDENT 0.0

-a, --archive-headers Display the information contained within an archive\(aqs headers. NINDENT NDENT 0.0

-d, --disassemble Disassemble all text sections found in the input files. NINDENT NDENT 0.0

-D, --disassemble-all Disassemble all sections found in the input files. NINDENT NDENT 0.0

--disassemble-symbols=<symbol1[,symbol2,...]> Disassemble only the specified symbols. Takes demangled symbol names when \%--demangle is specified, otherwise takes mangled symbol names. Implies \%--disassemble. NINDENT NDENT 0.0

--dwarf=<value> Dump the specified DWARF debug sections. The supported values are: frames - .debug_frame NINDENT NDENT 0.0

-f, --file-headers Display the contents of the overall file header. NINDENT NDENT 0.0

--fault-map-section Display the content of the fault map section. NINDENT NDENT 0.0

-h, --headers, --section-headers Display summaries of the headers for each section. NINDENT NDENT 0.0

--help Display usage information and exit. Does not stack with other commands. NINDENT NDENT 0.0

-p, --private-headers Display format-specific file headers. NINDENT NDENT 0.0

-r, --reloc Display the relocation entries in the file. NINDENT NDENT 0.0

-R, --dynamic-reloc Display the dynamic relocation entries in the file. NINDENT NDENT 0.0

--raw-clang-ast Dump the raw binary contents of the clang AST section. NINDENT NDENT 0.0

-s, --full-contents Display the contents of each section. NINDENT NDENT 0.0

-t, --syms Display the symbol table. NINDENT NDENT 0.0

-T, --dynamic-syms Display the contents of the dynamic symbol table. NINDENT NDENT 0.0

-u, --unwind-info Display the unwind info of the input(s). NINDENT NDENT 0.0

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

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

OPTIONS
llvm-objdump supports the following options: NDENT 0.0

--adjust-vma=<offset> Increase the displayed address in disassembly or section header printing by the specified offset. NINDENT NDENT 0.0

--arch-name=<string> Specify the target architecture when disassembling. Use \%--version for a list of available targets. NINDENT NDENT 0.0

-C, --demangle Demangle symbol names in the output. NINDENT NDENT 0.0

--debug-vars=<format> Print the locations (in registers or memory) of source-level variables alongside disassembly. format may be unicode or ascii, defaulting to unicode if omitted. NINDENT NDENT 0.0

--debug-vars-indent=<width> Distance to indent the source-level variable display, relative to the start of the disassembly. Defaults to 40 characters. NINDENT NDENT 0.0

-j, --section=<section1[,section2,...]> Perform commands on the specified sections only. For Mach-O use segment,section to specify the section name. NINDENT NDENT 0.0

-l, --line-numbers When disassembling, display source line numbers. Implies \%--disassemble. NINDENT NDENT 0.0

-M, --disassembler-options=<opt1[,opt2,...]> Pass target-specific disassembler options. Currently supported for ARM targets only. Available options are reg-names-std and reg-names-raw. NINDENT NDENT 0.0

--mcpu=<cpu-name> Target a specific CPU type for disassembly. Specify --mcpu=help to display available CPUs. NINDENT NDENT 0.0

--mattr=<a1,+a2,-a3,...> Enable/disable target-specific attributes. Specify --mattr=help to display the available attributes. NINDENT NDENT 0.0

--no-leading-addr When disassembling, do not print leading addresses. NINDENT NDENT 0.0

--no-show-raw-insn When disassembling, do not print the raw bytes of each instruction. NINDENT NDENT 0.0

--prefix=<prefix> When disassembling with the \%--source option, prepend prefix to absolute paths. NINDENT NDENT 0.0

--print-imm-hex Use hex format when printing immediate values in disassembly output. NINDENT NDENT 0.0

-S, --source When disassembling, display source interleaved with the disassembly. Implies \%--disassemble. NINDENT NDENT 0.0

--show-lma Display the LMA column when dumping ELF section headers. Defaults to off unless any section has different VMA and LMAs. NINDENT NDENT 0.0

--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. NINDENT NDENT 0.0

--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. NINDENT NDENT 0.0

--symbolize-operands When disassembling, symbolize a branch target operand to print a label instead of a real address. When printing a PC-relative global symbol reference, print it as an offset from the leading symbol. Only works with an X86 linked image. NDENT 7.0

Example: A non-symbolized branch instruction with a local target and pc-relative memory access like NINDENT NDENT 7.0 NDENT 3.5

cmp eax, dword ptr [rip + 4112]
jge 0x20117e <_start+0x25>
NINDENT NINDENT might become NDENT 7.0 NDENT 3.5
<L0>:
 cmp eax, dword ptr <g>
 jge <L0>
NINDENT NINDENT NINDENT NDENT 0.0

--triple=<string> Target triple to disassemble for, see --version for available targets. NINDENT NDENT 0.0

-w, --wide Ignored for compatibility with GNU objdump. NINDENT NDENT 0.0

--x86-asm-syntax=<style> When used with \%--disassemble, choose style of code to emit from X86 backend. Supported values are: NDENT 7.0 NDENT 3.5 NDENT 0.0

att AT&T-style assembly NINDENT NDENT 0.0

intel Intel-style assembly NINDENT NINDENT NINDENT The default disassembly style is att. NINDENT NDENT 0.0

-z, --disassemble-zeroes Do not skip blocks of zeroes when disassembling. NINDENT NDENT 0.0

@<FILE> Read command-line options and commands from response file <FILE>. NINDENT

MACH-O ONLY OPTIONS AND COMMANDS
NDENT 0.0

--arch=<architecture> Specify the architecture to disassemble. see --version for available architectures. NINDENT NDENT 0.0

--archive-member-offsets Print the offset to each archive member for Mach-O archives (requires \%--archive-headers). NINDENT NDENT 0.0

--bind Display binding info NINDENT NDENT 0.0

--cfg Create a CFG for every symbol in the object file and write it to a graphviz file. NINDENT NDENT 0.0

--data-in-code Display the data in code table. NINDENT NDENT 0.0

--dis-symname=<name> Disassemble just the specified symbol\(aqs instructions. NINDENT NDENT 0.0

--dylibs-used Display the shared libraries used for linked files. NINDENT NDENT 0.0

--dsym=<string> Use .dSYM file for debug info. NINDENT NDENT 0.0

--dylib-id Display the shared library\(aqs ID for dylib files. NINDENT NDENT 0.0

--exports-trie Display exported symbols. NINDENT NDENT 0.0

-g Print line information from debug info if available. NINDENT NDENT 0.0

--full-leading-addr Print the full leading address when disassembling. NINDENT NDENT 0.0

--indirect-symbols Display the indirect symbol table. NINDENT NDENT 0.0

--info-plist Display the info plist section as strings. NINDENT NDENT 0.0

--lazy-bind Display lazy binding info. NINDENT NDENT 0.0

--link-opt-hints Display the linker optimization hints. NINDENT NDENT 0.0

-m, --macho Use Mach-O specific object file parser. Commands and other options may behave differently when used with --macho. NINDENT NDENT 0.0

--no-leading-headers Do not print any leading headers. NINDENT NDENT 0.0

--no-symbolic-operands Do not print symbolic operands when disassembling. NINDENT NDENT 0.0

--non-verbose Display the information for Mach-O objects in non-verbose or numeric form. NINDENT NDENT 0.0

--objc-meta-data Display the Objective-C runtime meta data. NINDENT NDENT 0.0

--private-header Display only the first format specific file header. NINDENT NDENT 0.0

--rebase Display rebasing information. NINDENT NDENT 0.0

--universal-headers Display universal headers. NINDENT NDENT 0.0

--weak-bind Display weak binding information. NINDENT

XCOFF ONLY OPTIONS AND COMMANDS
NDENT 0.0

--symbol-description Add symbol description to disassembly output. NINDENT

BUGS
To report bugs, please visit <\%https://bugs.llvm.org/>.
SEE ALSO
llvm-nm(1), llvm-readelf(1), llvm-readobj(1)
AUTHOR
Maintained by the LLVM Team (https://llvm.org/).
COPYRIGHT
2003-2021, LLVM Project Generated by docutils manpage writer.
.