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