1LLVM-READOBJ(1) LLVM LLVM-READOBJ(1)
2
3
4
6 llvm-readobj - LLVM Object Reader
7
9 llvm-readobj [options] [input...]
10
12 The llvm-readobj tool displays low-level format-specific information
13 about one or more object files.
14
15 If input is "-", llvm-readobj reads from standard input. Otherwise, it
16 will read from the specified filenames.
17
19 llvm-readelf is an alias for the llvm-readobj tool with a slightly dif‐
20 ferent command-line interface and output that is GNU compatible. Fol‐
21 lowing is a list of differences between llvm-readelf and llvm-readobj:
22
23 • llvm-readelf uses GNU for the --elf-output-style option by default.
24 llvm-readobj uses LLVM.
25
26 • llvm-readelf allows single-letter grouped flags (e.g. llvm-readelf
27 -SW is the same as llvm-readelf -S -W). llvm-readobj does not allow
28 grouping.
29
30 • llvm-readelf provides -s as an alias for --symbols, for GNU readelf
31 compatibility, whereas it is an alias for --section-headers in
32 llvm-readobj.
33
34 • llvm-readobj provides -t as an alias for --symbols. llvm-readelf
35 does not.
36
37 • llvm-readobj provides --sr, --sd, --st and --dt as aliases for
38 --section-relocations, --section-data, --section-symbols and
39 --dyn-symbols respectively. llvm-readelf does not provide these
40 aliases, to avoid conflicting with grouped flags.
41
43 These options are applicable to more than one file format, or are unre‐
44 lated to file formats.
45
46 --all Equivalent to specifying all the main display options relevant
47 to the file format.
48
49 --addrsig
50 Display the address-significance table.
51
52 --expand-relocs
53 When used with --relocs, display each relocation in an expanded
54 multi-line format.
55
56 --file-header, -h
57 Display file headers.
58
59 --headers, -e
60 Equivalent to setting: --file-header, --program-headers, and
61 --sections.
62
63 --help Display a summary of command line options.
64
65 --hex-dump=<section[,section,...]>, -x
66 Display the specified section(s) as hexadecimal bytes. section
67 may be a section index or section name.
68
69 --needed-libs
70 Display the needed libraries.
71
72 --relocations, --relocs, -r
73 Display the relocation entries in the file.
74
75 --sections, --section-headers, -S
76 Display all sections.
77
78 --section-data, --sd
79 When used with --sections, display section data for each section
80 shown. This option has no effect for GNU style output.
81
82 --section-relocations, --sr
83 When used with --sections, display relocations for each section
84 shown. This option has no effect for GNU style output.
85
86 --section-symbols, --st
87 When used with --sections, display symbols for each section
88 shown. This option has no effect for GNU style output.
89
90 --stackmap
91 Display contents of the stackmap section.
92
93 --string-dump=<section[,section,...]>, -p
94 Display the specified section(s) as a list of strings. section
95 may be a section index or section name.
96
97 --string-table
98 Display contents of the string table.
99
100 --symbols, --syms, -s
101 Display the symbol table.
102
103 --unwind, -u
104 Display unwind information.
105
106 --version
107 Display the version of the llvm-readobj executable.
108
109 @<FILE>
110 Read command-line options from response file <FILE>.
111
113 The following options are implemented only for the ELF file format.
114
115 --arch-specific, -A
116 Display architecture-specific information, e.g. the ARM at‐
117 tributes section on ARM.
118
119 --bb-addr-map
120 Display the contents of the basic block address map section(s),
121 which contain the address of each function, along with the rela‐
122 tive offset of each basic block.
123
124 --demangle, -C
125 Display demangled symbol names in the output.
126
127 --dependent-libraries
128 Display the dependent libraries section.
129
130 --dyn-relocations
131 Display the dynamic relocation entries.
132
133 --dyn-symbols, --dyn-syms, --dt
134 Display the dynamic symbol table.
135
136 --dynamic-table, --dynamic, -d
137 Display the dynamic table.
138
139 --cg-profile
140 Display the callgraph profile section.
141
142 --histogram, -I
143 Display a bucket list histogram for dynamic symbol hash tables.
144
145 --elf-linker-options
146 Display the linker options section.
147
148 --elf-output-style=<value>
149 Format ELF information in the specified style. Valid options are
150 LLVM, GNU, and JSON. LLVM output (the default) is an expanded
151 and structured format. GNU output mimics the equivalent GNU
152 readelf output. JSON is JSON formatted output intended for ma‐
153 chine consumption.
154
155 --section-groups, -g
156 Display section groups.
157
158 --gnu-hash-table
159 Display the GNU hash table for dynamic symbols.
160
161 --hash-symbols
162 Display the expanded hash table with dynamic symbol data.
163
164 --hash-table
165 Display the hash table for dynamic symbols.
166
167 --notes, -n
168 Display all notes.
169
170 --pretty-print
171 When used with --elf-output-style, JSON output will be formatted
172 in a more readable format.
173
174 --program-headers, --segments, -l
175 Display the program headers.
176
177 --raw-relr
178 Do not decode relocations in RELR relocation sections when dis‐
179 playing them.
180
181 --section-mapping
182 Display the section to segment mapping.
183
184 --stack-sizes
185 Display the contents of the stack sizes section(s), i.e. pairs
186 of function names and the size of their stack frames. Currently
187 only implemented for GNU style output.
188
189 --version-info, -V
190 Display version sections.
191
193 The following options are implemented only for the Mach-O file format.
194
195 --macho-data-in-code
196 Display the Data in Code command.
197
198 --macho-dsymtab
199 Display the Dsymtab command.
200
201 --macho-indirect-symbols
202 Display indirect symbols.
203
204 --macho-linker-options
205 Display the Mach-O-specific linker options.
206
207 --macho-segment
208 Display the Segment command.
209
210 --macho-version-min
211 Display the version min command.
212
214 The following options are implemented only for the PE/COFF file format.
215
216 --codeview
217 Display CodeView debug information.
218
219 --codeview-ghash
220 Enable global hashing for CodeView type stream de-duplication.
221
222 --codeview-merged-types
223 Display the merged CodeView type stream.
224
225 --codeview-subsection-bytes
226 Dump raw contents of CodeView debug sections and records.
227
228 --coff-basereloc
229 Display the .reloc section.
230
231 --coff-debug-directory
232 Display the debug directory.
233
234 --coff-tls-directory
235 Display the TLS directory.
236
237 --coff-directives
238 Display the .drectve section.
239
240 --coff-exports
241 Display the export table.
242
243 --coff-imports
244 Display the import table.
245
246 --coff-load-config
247 Display the load config.
248
249 --coff-resources
250 Display the .rsrc section.
251
253 The following options are implemented only for the XCOFF file format.
254
255 --auxiliary-header
256 Display XCOFF Auxiliary header.
257
259 llvm-readobj returns 0 under normal operation. It returns a non-zero
260 exit code if there were any errors.
261
263 llvm-nm(1), llvm-objdump(1), llvm-readelf(1)
264
266 Maintained by the LLVM Team (https://llvm.org/).
267
269 2003-2022, LLVM Project
270
271
272
273
27414 2022-09-12 LLVM-READOBJ(1)