xref: /freebsd/usr.bin/clang/llvm-objdump/llvm-objdump.1 (revision 801cfbaa3f368c06bbdf297d78fa8ad80e0ae3cb)
1.\" This file is distributed under the University of Illinois Open Source
2.\" License.
3.\"
4.Dd November 26, 2018
5.Dt LLVM-OBJDUMP 1
6.Os
7.Sh NAME
8.Nm llvm-objdump
9.Nd LLVM object file dumper
10.Sh SYNOPSIS
11.Nm llvm-objdump
12.Op Ar options
13.Ar objfile ...
14.Sh DESCRIPTION
15.Nm
16prints the contents of object files and final linked images named on the
17command line.
18If no file name is specified,
19.Nm
20will attempt to read from
21.Pa a.out .
22If
23.Pa -
24is used as a file name,
25.Nm
26will process a file on its standard input stream.
27.Nm
28accepts many of the same command line arguments as GNU objdump.
29.Sh OPTIONS
30.Ss General Options
31.Bl -tag -width indent
32.It Fl -aarch64-neon-syntax Ns = Ns Ar value
33Choose style of NEON code to emit from AArch64 backend.
34.Ar value
35may be one of:
36.Bl -tag -width indent
37.It generic
38Generic NEON assembly
39.It apple
40Apple-style NEON assembly
41.El
42.It Fl -arch Ns = Ns Ar value
43Choose architecture(s) from a Mach-O file to dump
44.It Fl -arch-name Ns = Ns ar arch
45Target arch to disassemble for.
46See
47.Fl -version
48for available targets.
49.It Fl -bind
50Display mach-o binding info.
51.It Fl -color
52Use colored syntax highlighting.
53Default autodetect.
54.It Fl -disassemble
55Display assembler mnemonics for machine instructions.
56.It Fl -disassemble-all
57Display assembler mnemonics for the machine instruction in all sections.
58.It Fl -dsym Ns = Ns Ar file
59Use
60.Ar file
61for debug info.
62.It Fl -dwarf Ns = Ns Ar sections
63Dump of dwarf debug sections.
64.Bl -tag -width indent
65.It frames
66.Dv .debug_frame
67.El
68.It Fl -exports-trie
69Display mach-o exported symbols.
70.It Fl -fault-map-section
71Display contents of faultmap section.
72.It Fl -filter-print-funcs Ns = Ns Ar functions
73Only print IR for functions whose name match
74.Ar functions
75for all print-[before|after][-all] options.
76.It Fl -full-leading-addr
77Print full leading address.
78.It Fl g
79Print line information from debug info if available.
80.It Fl h , -headers , -section-headers
81Display summaries of the headers for each section.
82.It Fl -help
83Display available options.
84Use
85.Fl -help-hidden
86for more.
87.It Fl -lazy-bind
88Display mach-o lazy binding info.
89.It Fl -line-numbers
90Display source line numbers with disassembly. Implies disassemble object.
91.It Fl -macho
92Use MachO specific object file parser.
93.It Fl -mattr Ns = Ns Ar attribute ...
94Target specific attributes.
95.It Fl -mcpu Ns = Ns Ar CPU
96Target a specific cpu type.
97Use
98.Fl mcpu Ns = Ns help
99for details.
100.It Fl -no-leading-addr
101Print no leading address.
102.It Fl -no-leading-headers
103Print no leading headers.
104.It Fl -no-show-raw-insn
105When disassembling instructions, do not print the instruction bytes.
106.It Fl -print-after-all
107Print IR after each pass.
108.It Fl -print-before-all
109Print IR before each pass.
110.It Fl -print-imm-hex
111Use hex format for immediate values.
112.It Fl -private-header
113Display only the first format specific file header.
114.It Fl -private-headers
115Display format specific file headers.
116.It Fl r
117Display the relocation entries in the file.
118.It Fl -raw-clang-ast
119Dump the raw binary contents of the clang AST section.
120.It Fl -rebase
121Display mach-o rebasing info.
122.It Fl -reverse-iterate
123Reverse iterate.
124.It Fl -rng-seed Ns = Ns Ar seed
125Seed for the random number generator.
126.It Fl s
127Display the content of each section.
128.It Fl -section Ns = Ns Ar section
129Operate on the specified sections only.
130With
131.Fl -macho
132dump segment,section.
133.It Fl -source
134Display source inline with disassembly.
135Implies disassmble object.
136.It Fl -start-address Ns = Ns Ar address
137Disassemble beginning at
138.Ar address .
139.It Fl -stats
140Enable statistics output from program.
141Available with Asserts builds.
142.It Fl -stats-json
143Display statistics as json data.
144.It Fl -stop-address Ns = Ns Ar address
145Stop disassembly at
146.Ar address .
147.It Fl t
148Display the symbol table.
149.It Fl -time-passes
150Time each pass, printing elapsed time for each on exit
151.It Fl -triple Ns = Ns Ar triple
152Target triple to disassemble for.
153See
154.Fl -version
155for available targets.
156.It Fl -unwind-info
157Display unwind information.
158.It Fl -verify-debug-info
159Verify debug info.
160.It Fl -verify-dom-info
161Verify dominator info (time consuming).
162.It Fl -version
163Display the version of this program.
164.It Fl -weak-bind
165Display mach-o weak binding info.
166.It Fl -x86-asm-syntax Ns = Ns Ar syntax
167Choose style of code to emit from X86 backend.
168.Bl -tag -width indent
169.It att
170Emit AT&T-style assembly.
171.It intel
172Emit Intel-style assembly.
173.El
174.El
175.Ss Mach-O Options
176There are a number of options specific to the Mach-O format.
177These are used in combination with the
178.Fl -macho
179option.
180.Bl -tag -width indent
181.It Fl -archive-headers
182Print archive headers for Mach-O archives.
183.It Fl -archive-member-offsets
184Print the offset to each archive member for Mach-O archives.
185Requires
186.Fl -macho
187and
188.Fl -archive-headers.
189.It Fl -data-in-code
190Print the data in code table for Mach-O objects.
191.It Fl -dis-symname Ns = Ns Ar symbol
192Disassemble just
193.Ar symbol 's
194instructions.
195.It Fl -dylib-id
196Print the shared library's id for the dylib Mach-O file.
197.It Fl -dylibs-used
198Print the shared libraries used for linked Mach-O files.
199.It Fl -indirect-symbols
200Print indirect symbol table for Mach-O objects.
201.It Fl -info-plist
202Print the info plist section as strings for Mach-O objects.
203.It Fl -link-opt-hints
204Print the linker optimization hints for Mach-O objects.
205.It Fl -no-symbolic-operands
206do not symbolic operands when disassembling.
207.It Fl -non-verbose
208Print the info for Mach-O objects in non-verbose or numeric form.
209.It Fl -objc-meta-data
210Print the Objective-C runtime meta data for Mach-O files.
211.It Fl -universal-headers
212Print Mach-O universal headers.
213.El
214