1LLVM-READOBJ(1)                      LLVM                      LLVM-READOBJ(1)
2
3
4

NAME

6       llvm-readobj - LLVM Object Reader
7

SYNOPSIS

9       llvm-readobj [options] [input...]
10

DESCRIPTION

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

DIFFERENCES TO LLVM-READELF

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

GENERAL AND MULTI-FORMAT OPTIONS

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

ELF SPECIFIC OPTIONS

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

MACH-O SPECIFIC OPTIONS

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

PE/COFF SPECIFIC OPTIONS

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

XCOFF SPECIFIC OPTIONS

253       The following options are implemented only for the XCOFF file format.
254
255       --auxiliary-header
256              Display XCOFF Auxiliary header.
257

EXIT STATUS

259       llvm-readobj returns 0 under normal operation. It  returns  a  non-zero
260       exit code if there were any errors.
261

SEE ALSO

263       llvm-nm(1), llvm-objdump(1), llvm-readelf(1)
264

AUTHOR

266       Maintained by the LLVM Team (https://llvm.org/).
267

COPYRIGHT

269       2003-2023, LLVM Project
270
271
272
273
27414                                2023-07-20                   LLVM-READOBJ(1)