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 "-" or omitted, llvm-readobj  reads  from  standard  input.
16       Otherwise, it 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
57              expanded 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 this program.
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       --arm-attributes
119              Display  the  ARM  attributes  section.  Only applicable for ARM
120              architectures.
121
122       --demangle, -C
123              Display demangled symbol names in the output.
124
125       --dyn-relocations
126              Display the dynamic relocation entries.
127
128       --dyn-symbols, --dyn-syms, --dt
129              Display the dynamic symbol table.
130
131       --dynamic-table, --dynamic, -d
132              Display the dynamic table.
133
134       --elf-cg-profile
135              Display the callgraph profile section.
136
137       --elf-hash-histogram, --histogram, -I
138              Display a bucket list histogram for dynamic symbol hash tables.
139
140       --elf-linker-options
141              Display the linker options section.
142
143       --elf-output-style=<value>
144              Format ELF information in the specified style. Valid options are
145              LLVM  and  GNU.  LLVM  output  (the  default) is an expanded and
146              structured format, whilst GNU output mimics the  equivalent  GNU
147              readelf output.
148
149       --elf-section-groups, --section-groups, -g
150              Display section groups.
151
152       --gnu-hash-table
153              Display the GNU hash table for dynamic symbols.
154
155       --hash-symbols
156              Display the expanded hash table with dynamic symbol data.
157
158       --hash-table
159              Display the hash table for dynamic symbols.
160
161       --notes, -n
162              Display all notes.
163
164       --program-headers, --segments, -l
165              Display the program headers.
166
167       --raw-relr
168              Do  not decode relocations in RELR relocation sections when dis‐
169              playing them.
170
171       --section-mapping
172              Display the section to segment mapping.
173
174       --version-info, -V
175              Display version sections.
176

MACH-O SPECIFIC OPTIONS

178       The following options are implemented only for the Mach-O file format.
179
180       --macho-data-in-code
181              Display the Data in Code command.
182
183       --macho-dsymtab
184              Display the Dsymtab command.
185
186       --macho-indirect-symbols
187              Display indirect symbols.
188
189       --macho-linker-options
190              Display the Mach-O-specific linker options.
191
192       --macho-segment
193              Display the Segment command.
194
195       --macho-version-min
196              Display the version min command.
197

PE/COFF SPECIFIC OPTIONS

199       The following options are implemented only for the PE/COFF file format.
200
201       --codeview
202              Display CodeView debug information.
203
204       --codeview-ghash
205              Enable global hashing for CodeView type stream de-duplication.
206
207       --codeview-merged-types
208              Display the merged CodeView type stream.
209
210       --codeview-subsection-bytes
211              Dump raw contents of CodeView debug sections and records.
212
213       --coff-basereloc
214              Display the .reloc section.
215
216       --coff-debug-directory
217              Display the debug directory.
218
219       --coff-directives
220              Display the .drectve section.
221
222       --coff-exports
223              Display the export table.
224
225       --coff-imports
226              Display the import table.
227
228       --coff-load-config
229              Display the load config.
230
231       --coff-resources
232              Display the .rsrc section.
233

EXIT STATUS

235       llvm-readobj returns 0 under normal operation. It  returns  a  non-zero
236       exit code if there were any errors.
237

SEE ALSO

239       llvm-nm(1), llvm-objdump(1), llvm-readelf(1)
240

AUTHOR

242       Maintained by the LLVM Team (https://llvm.org/).
243

COPYRIGHT

245       2003-2020, LLVM Project
246
247
248
249
2509                                 2020-08-12                   LLVM-READOBJ(1)