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       --color
53              Use colors in the output for warnings and errors.
54
55       --expand-relocs
56              When used with --relocations, display each relocation in an  ex‐
57              panded multi-line format.
58
59       --file-headers, -h
60              Display file headers.
61
62       --headers, -e
63              Equivalent  to  setting:  --file-headers, --program-headers, and
64              --sections.
65
66       --help Display a summary of command line options.
67
68       --help-list
69              Display an uncategorized summary of command line options.
70
71       --hex-dump=<section[,section,...]>, -x
72              Display the specified section(s) as hexadecimal  bytes.  section
73              may be a section index or section name.
74
75       --needed-libs
76              Display the needed libraries.
77
78       --relocations, --relocs, -r
79              Display the relocation entries in the file.
80
81       --sections, --section-headers, -s, -S
82              Display all sections.
83
84       --section-data, --sd
85              When used with --sections, display section data for each section
86              shown. This option has no effect for GNU style output.
87
88       --section-relocations, --sr
89              When used with --sections, display relocations for each  section
90              shown. This option has no effect for GNU style output.
91
92       --section-symbols, --st
93              When  used  with  --sections,  display  symbols for each section
94              shown.  This option has no effect for GNU style output.
95
96       --stackmap
97              Display contents of the stackmap section.
98
99       --string-dump=<section[,section,...]>, -p
100              Display the specified section(s) as a list of  strings.  section
101              may be a section index or section name.
102
103       --symbols, --syms, -t
104              Display the symbol table.
105
106       --unwind, -u
107              Display unwind information.
108
109       --version
110              Display the version of the llvm-readobj executable.
111
112       @<FILE>
113              Read command-line options from response file <FILE>.
114

ELF SPECIFIC OPTIONS

116       The following options are implemented only for the ELF file format.
117
118       --arch-specific, -A
119              Display  architecture-specific  information,  e.g.  the  ARM at‐
120              tributes section on ARM.
121
122       --demangle, -C
123              Display demangled symbol names in the output.
124
125       --dependent-libraries
126              Display the dependent libraries section.
127
128       --dyn-relocations
129              Display the dynamic relocation entries.
130
131       --dyn-symbols, --dyn-syms, --dt
132              Display the dynamic symbol table.
133
134       --dynamic-table, --dynamic, -d
135              Display the dynamic table.
136
137       --cg-profile
138              Display the callgraph profile section.
139
140       --elf-hash-histogram, --histogram, -I
141              Display a bucket list histogram for dynamic symbol hash tables.
142
143       --elf-linker-options
144              Display the linker options section.
145
146       --elf-output-style=<value>
147              Format ELF information in the specified style. Valid options are
148              LLVM  and  GNU.  LLVM  output  (the  default) is an expanded and
149              structured format, whilst GNU output mimics the  equivalent  GNU
150              readelf output.
151
152       --elf-section-groups, --section-groups, -g
153              Display section groups.
154
155       --gnu-hash-table
156              Display the GNU hash table for dynamic symbols.
157
158       --hash-symbols
159              Display the expanded hash table with dynamic symbol data.
160
161       --hash-table
162              Display the hash table for dynamic symbols.
163
164       --notes, -n
165              Display all notes.
166
167       --program-headers, --segments, -l
168              Display the program headers.
169
170       --raw-relr
171              Do  not decode relocations in RELR relocation sections when dis‐
172              playing them.
173
174       --section-mapping
175              Display the section to segment mapping.
176
177       --stack-sizes
178              Display the contents of the stack sizes section(s),  i.e.  pairs
179              of  function names and the size of their stack frames. Currently
180              only implemented for GNU style output.
181
182       --version-info, -V
183              Display version sections.
184

MACH-O SPECIFIC OPTIONS

186       The following options are implemented only for the Mach-O file format.
187
188       --macho-data-in-code
189              Display the Data in Code command.
190
191       --macho-dsymtab
192              Display the Dsymtab command.
193
194       --macho-indirect-symbols
195              Display indirect symbols.
196
197       --macho-linker-options
198              Display the Mach-O-specific linker options.
199
200       --macho-segment
201              Display the Segment command.
202
203       --macho-version-min
204              Display the version min command.
205

PE/COFF SPECIFIC OPTIONS

207       The following options are implemented only for the PE/COFF file format.
208
209       --codeview
210              Display CodeView debug information.
211
212       --codeview-ghash
213              Enable global hashing for CodeView type stream de-duplication.
214
215       --codeview-merged-types
216              Display the merged CodeView type stream.
217
218       --codeview-subsection-bytes
219              Dump raw contents of CodeView debug sections and records.
220
221       --coff-basereloc
222              Display the .reloc section.
223
224       --coff-debug-directory
225              Display the debug directory.
226
227       --coff-tls-directory
228              Display the TLS directory.
229
230       --coff-directives
231              Display the .drectve section.
232
233       --coff-exports
234              Display the export table.
235
236       --coff-imports
237              Display the import table.
238
239       --coff-load-config
240              Display the load config.
241
242       --coff-resources
243              Display the .rsrc section.
244

EXIT STATUS

246       llvm-readobj returns 0 under normal operation. It  returns  a  non-zero
247       exit code if there were any errors.
248

SEE ALSO

250       llvm-nm(1), llvm-objdump(1), llvm-readelf(1)
251

AUTHOR

253       Maintained by the LLVM Team (https://llvm.org/).
254

COPYRIGHT

256       2003-2021, LLVM Project
257
258
259
260
26112                                2021-07-22                   LLVM-READOBJ(1)