xref: /freebsd/usr.bin/clang/llvm-objdump/llvm-objdump.1 (revision 7a1772ed425b7df6fe72f0d0c28983d0e30f76db)
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-imm-hex
107Use hex format for immediate values.
108.It Fl -private-header
109Display only the first format specific file header.
110.It Fl -private-headers
111Display format specific file headers.
112.It Fl r
113Display the relocation entries in the file.
114.It Fl -raw-clang-ast
115Dump the raw binary contents of the clang AST section.
116.It Fl -rebase
117Display mach-o rebasing info.
118.It Fl -reverse-iterate
119Reverse iterate.
120.It Fl -rng-seed Ns = Ns Ar seed
121Seed for the random number generator.
122.It Fl s
123Display the content of each section.
124.It Fl -section Ns = Ns Ar section
125Operate on the specified sections only.
126With
127.Fl -macho
128dump segment,section.
129.It Fl -source
130Display source inline with disassembly.
131Implies disassmble object.
132.It Fl -start-address Ns = Ns Ar address
133Disassemble beginning at
134.Ar address .
135.It Fl -stats
136Enable statistics output from program.
137Available with Asserts builds.
138.It Fl -stats-json
139Display statistics as json data.
140.It Fl -stop-address Ns = Ns Ar address
141Stop disassembly at
142.Ar address .
143.It Fl t
144Display the symbol table.
145.It Fl -time-passes
146Time each pass, printing elapsed time for each on exit
147.It Fl -triple Ns = Ns Ar triple
148Target triple to disassemble for.
149See
150.Fl -version
151for available targets.
152.It Fl -unwind-info
153Display unwind information.
154.It Fl -version
155Display the version of this program.
156.It Fl -weak-bind
157Display mach-o weak binding info.
158.It Fl -x86-asm-syntax Ns = Ns Ar syntax
159Choose style of code to emit from X86 backend.
160.Bl -tag -width indent
161.It att
162Emit AT&T-style assembly.
163.It intel
164Emit Intel-style assembly.
165.El
166.El
167.Ss Mach-O Options
168There are a number of options specific to the Mach-O format.
169These are used in combination with the
170.Fl -macho
171option.
172.Bl -tag -width indent
173.It Fl -archive-headers
174Print archive headers for Mach-O archives.
175.It Fl -archive-member-offsets
176Print the offset to each archive member for Mach-O archives.
177Requires
178.Fl -macho
179and
180.Fl -archive-headers.
181.It Fl -data-in-code
182Print the data in code table for Mach-O objects.
183.It Fl -dis-symname Ns = Ns Ar symbol
184Disassemble just
185.Ar symbol 's
186instructions.
187.It Fl -dylib-id
188Print the shared library's id for the dylib Mach-O file.
189.It Fl -dylibs-used
190Print the shared libraries used for linked Mach-O files.
191.It Fl -indirect-symbols
192Print indirect symbol table for Mach-O objects.
193.It Fl -info-plist
194Print the info plist section as strings for Mach-O objects.
195.It Fl -link-opt-hints
196Print the linker optimization hints for Mach-O objects.
197.It Fl -no-symbolic-operands
198do not symbolic operands when disassembling.
199.It Fl -non-verbose
200Print the info for Mach-O objects in non-verbose or numeric form.
201.It Fl -objc-meta-data
202Print the Objective-C runtime meta data for Mach-O files.
203.It Fl -universal-headers
204Print Mach-O universal headers.
205.El
206