1LLVM-OBJDUMP(1) LLVM LLVM-OBJDUMP(1)
2
6 llvm-objdump - LLVM's object file dumper
7
9 llvm-objdump [commands] [options] [filenames...]
10
12 The llvm-objdump utility prints the contents of object files and final
13 linked images named on the command line. If no file name is specified,
14 llvm-objdump will attempt to read from a.out. If - is used as a file
15 name, llvm-objdump will process a file on its standard input stream.
16
18 At least one of the following commands are required, and some commands
19 can be combined with other commands:
20 -a, --archive-headers
22 Display the information contained within an archive's headers.
23 -d, --disassemble
25 Disassemble all text sections found in the input files.
26 -D, --disassemble-all
28 Disassemble all sections found in the input files.
29 --disassemble-symbols=<symbol1[,symbol2,...]>
31 Disassemble only the specified symbols. Takes demangled symbol
32 names when --demangle is specified, otherwise takes mangled sym‐
33 bol names. Implies --disassemble.
34 --dwarf=<value>
36 Dump the specified DWARF debug sections. The supported values
37 are:
38 frames - .debug_frame
40 -f, --file-headers
42 Display the contents of the overall file header.
43 --fault-map-section
45 Display the content of the fault map section.
46 -h, --headers, --section-headers
48 Display summaries of the headers for each section.
49 --help Display usage information and exit. Does not stack with other
51 commands.
52 -p, --private-headers
54 Display format-specific file headers.
55 -r, --reloc
57 Display the relocation entries in the file.
58 -R, --dynamic-reloc
60 Display the dynamic relocation entries in the file.
61 --raw-clang-ast
63 Dump the raw binary contents of the clang AST section.
64 -s, --full-contents
66 Display the contents of each section.
67 -t, --syms
69 Display the symbol table.
70 -T, --dynamic-syms
72 Display the contents of the dynamic symbol table.
73 -u, --unwind-info
75 Display the unwind info of the input(s).
76 --version
78 Display the version of the llvm-objdump executable. Does not
79 stack with other commands.
80 -x, --all-headers
82 Display all available header information. Equivalent to specify‐
83 ing --archive-headers, --file-headers, --private-headers,
84 --reloc, --section-headers, and --syms.
85
87 llvm-objdump supports the following options:
88 --adjust-vma=<offset>
90 Increase the displayed address in disassembly or section header
91 printing by the specified offset.
92 --arch-name=<string>
94 Specify the target architecture when disassembling. Use
95 --version for a list of available targets.
96 -C, --demangle
98 Demangle symbol names in the output.
99 --debug-vars=<format>
101 Print the locations (in registers or memory) of source-level
102 variables alongside disassembly. format may be unicode or ascii,
103 defaulting to unicode if omitted.
104 --debug-vars-indent=<width>
106 Distance to indent the source-level variable display, relative
107 to the start of the disassembly. Defaults to 40 characters.
108 -j, --section=<section1[,section2,...]>
110 Perform commands on the specified sections only. For Mach-O use
111 segment,section to specify the section name.
112 -l, --line-numbers
114 When disassembling, display source line numbers. Implies
115 --disassemble.
116 -M, --disassembler-options=<opt1[,opt2,...]>
118 Pass target-specific disassembler options. Currently supported
119 for ARM targets only. Available options are reg-names-std and
120 reg-names-raw.
121 --mcpu=<cpu-name>
123 Target a specific CPU type for disassembly. Specify --mcpu=help
124 to display available CPUs.
125 --mattr=<a1,+a2,-a3,...>
127 Enable/disable target-specific attributes. Specify --mattr=help
128 to display the available attributes.
129 --no-leading-addr
131 When disassembling, do not print leading addresses.
132 --no-show-raw-insn
134 When disassembling, do not print the raw bytes of each instruc‐
135 tion.
136 --prefix=<prefix>
138 When disassembling with the --source option, prepend prefix to
139 absolute paths.
140 --print-imm-hex
142 Use hex format when printing immediate values in disassembly
143 output.
144 -S, --source
146 When disassembling, display source interleaved with the disas‐
147 sembly. Implies --disassemble.
148 --show-lma
150 Display the LMA column when dumping ELF section headers. De‐
151 faults to off unless any section has different VMA and LMAs.
152 --start-address=<address>
154 When disassembling, only disassemble from the specified address.
155 When printing relocations, only print the relocations patching
157 offsets from at least address.
158 When printing symbols, only print symbols with a value of at
160 least address.
161 --stop-address=<address>
163 When disassembling, only disassemble up to, but not including
164 the specified address.
165 When printing relocations, only print the relocations patching
167 offsets up to address.
168 When printing symbols, only print symbols with a value up to ad‐
170 dress.
171 --symbolize-operands
173 When disassembling, symbolize a branch target operand to print a
174 label instead of a real address.
175 When printing a PC-relative global symbol reference, print it as
177 an offset from the leading symbol.
178 Only works with an X86 linked image.
180 Example:
182 A non-symbolized branch instruction with a local target
183 and pc-relative memory access like
184 cmp eax, dword ptr [rip + 4112]
186 jge 0x20117e <_start+0x25>
187 might become
189 <L0>:
191 cmp eax, dword ptr <g>
192 jge <L0>
193 --triple=<string>
195 Target triple to disassemble for, see --version for available
196 targets.
197 -w, --wide
199 Ignored for compatibility with GNU objdump.
200 --x86-asm-syntax=<style>
202 When used with --disassemble, choose style of code to emit from
203 X86 backend. Supported values are:
204 att AT&T-style assembly
206 intel Intel-style assembly
208 The default disassembly style is att.
210 -z, --disassemble-zeroes
212 Do not skip blocks of zeroes when disassembling.
213 @<FILE>
215 Read command-line options and commands from response file
216 <FILE>.
217
219 --arch=<architecture>
220 Specify the architecture to disassemble. see --version for
221 available architectures.
222 --archive-member-offsets
224 Print the offset to each archive member for Mach-O archives (re‐
225 quires --archive-headers).
226 --bind Display binding info
228 --cfg Create a CFG for every symbol in the object file and write it to
230 a graphviz file.
231 --data-in-code
233 Display the data in code table.
234 --dis-symname=<name>
236 Disassemble just the specified symbol's instructions.
237 --dylibs-used
239 Display the shared libraries used for linked files.
240 --dsym=<string>
242 Use .dSYM file for debug info.
243 --dylib-id
245 Display the shared library's ID for dylib files.
246 --exports-trie
248 Display exported symbols.
249 -g Print line information from debug info if available.
251 --full-leading-addr
253 Print the full leading address when disassembling.
254 --indirect-symbols
256 Display the indirect symbol table.
257 --info-plist
259 Display the info plist section as strings.
260 --lazy-bind
262 Display lazy binding info.
263 --link-opt-hints
265 Display the linker optimization hints.
266 -m, --macho
268 Use Mach-O specific object file parser. Commands and other op‐
269 tions may behave differently when used with --macho.
270 --no-leading-headers
272 Do not print any leading headers.
273 --no-symbolic-operands
275 Do not print symbolic operands when disassembling.
276 --non-verbose
278 Display the information for Mach-O objects in non-verbose or nu‐
279 meric form.
280 --objc-meta-data
282 Display the Objective-C runtime meta data.
283 --private-header
285 Display only the first format specific file header.
286 --rebase
288 Display rebasing information.
289 --universal-headers
291 Display universal headers.
292 --weak-bind
294 Display weak binding information.
295
297 --symbol-description
298 Add symbol description to disassembly output.
299
301 To report bugs, please visit <https://bugs.llvm.org/>.
302
304 llvm-nm(1), llvm-readelf(1), llvm-readobj(1)
305
307 Maintained by the LLVM Team (https://llvm.org/).
308
310 2003-2023, LLVM Project
31112 2023-07-20 LLVM-OBJDUMP(1)