1llvm-readelf - GNU-style LLVM Object Reader
2===========================================
3
4.. program:: llvm-readelf
5
6SYNOPSIS
7--------
8
9:program:`llvm-readelf` [*options*] [*input...*]
10
11DESCRIPTION
12-----------
13
14The :program:`llvm-readelf` tool displays low-level format-specific information
15about one or more object files.
16
17If ``input`` is "``-``", :program:`llvm-readelf` reads from standard
18input. Otherwise, it will read from the specified ``filenames``.
19
20OPTIONS
21-------
22
23.. option:: --all
24
25 Equivalent to specifying all the main display options.
26
27.. option:: --addrsig
28
29 Display the address-significance table.
30
31.. option:: --arch-specific, -A
32
33 Display architecture-specific information, e.g. the ARM attributes section on ARM.
34
35.. option:: --bb-addr-map
36
37 Display the contents of the basic block address map section(s), which contain the
38 address of each function, along with the relative offset of each basic block.
39
40.. option:: --demangle, -C
41
42 Display demangled symbol names in the output.
43
44.. option:: --dyn-relocations
45
46 Display the dynamic relocation entries.
47
48.. option:: --dyn-symbols, --dyn-syms
49
50 Display the dynamic symbol table.
51
52.. option:: --dynamic-table, --dynamic, -d
53
54 Display the dynamic table.
55
56.. option:: --cg-profile
57
58 Display the callgraph profile section.
59
60.. option:: --elf-hash-histogram, --histogram, -I
61
62 Display a bucket list histogram for dynamic symbol hash tables.
63
64.. option:: --elf-linker-options
65
66 Display the linker options section.
67
68.. option:: --elf-output-style=<value>
69
70 Format ELF information in the specified style. Valid options are ``LLVM`` and
71 ``GNU``. ``LLVM`` output is an expanded and structured format, whilst ``GNU``
72 (the default) output mimics the equivalent GNU :program:`readelf` output.
73
74.. option:: --elf-section-groups, --section-groups, -g
75
76 Display section groups.
77
78.. option:: --expand-relocs
79
80 When used with :option:`--relocations`, display each relocation in an expanded
81 multi-line format.
82
83.. option:: --file-header, -h
84
85 Display file headers.
86
87.. option:: --gnu-hash-table
88
89 Display the GNU hash table for dynamic symbols.
90
91.. option:: --hash-symbols
92
93 Display the expanded hash table with dynamic symbol data.
94
95.. option:: --hash-table
96
97 Display the hash table for dynamic symbols.
98
99.. option:: --headers, -e
100
101 Equivalent to setting: :option:`--file-headers`, :option:`--program-headers`,
102 and :option:`--sections`.
103
104.. option:: --help
105
106 Display a summary of command line options.
107
108.. option:: --hex-dump=<section[,section,...]>, -x
109
110 Display the specified section(s) as hexadecimal bytes. ``section`` may be a
111 section index or section name.
112
113.. option:: --needed-libs
114
115 Display the needed libraries.
116
117.. option:: --notes, -n
118
119 Display all notes.
120
121.. option:: --program-headers, --segments, -l
122
123 Display the program headers.
124
125.. option:: --raw-relr
126
127 Do not decode relocations in RELR relocation sections when displaying them.
128
129.. option:: --relocations, --relocs, -r
130
131 Display the relocation entries in the file.
132
133.. option:: --sections, --section-headers, -S
134
135 Display all sections.
136
137.. option:: --section-data
138
139 When used with :option:`--sections`, display section data for each section
140 shown. This option has no effect for GNU style output.
141
142.. option:: --section-details, -t
143
144 Display all section details. Used as an alternative to :option:`--sections`.
145
146.. option:: --section-mapping
147
148 Display the section to segment mapping.
149
150.. option:: --section-relocations
151
152 When used with :option:`--sections`, display relocations for each section
153 shown. This option has no effect for GNU style output.
154
155.. option:: --section-symbols
156
157 When used with :option:`--sections`, display symbols for each section shown.
158 This option has no effect for GNU style output.
159
160.. option:: --stackmap
161
162 Display contents of the stackmap section.
163
164.. option:: --stack-sizes
165
166 Display the contents of the stack sizes section(s), i.e. pairs of function
167 names and the size of their stack frames. Currently only implemented for GNU
168 style output.
169
170.. option:: --string-dump=<section[,section,...]>, -p
171
172 Display the specified section(s) as a list of strings. ``section`` may be a
173 section index or section name.
174
175.. option:: --symbols, --syms, -s
176
177 Display the symbol table.
178
179.. option:: --unwind, -u
180
181 Display unwind information.
182
183.. option:: --version
184
185 Display the version of the :program:`llvm-readelf` executable.
186
187.. option:: --version-info, -V
188
189 Display version sections.
190
191.. option:: @<FILE>
192
193 Read command-line options from response file `<FILE>`.
194
195EXIT STATUS
196-----------
197
198:program:`llvm-readelf` returns 0 under normal operation. It returns a non-zero
199exit code if there were any errors.
200
201SEE ALSO
202--------
203
204:manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`, :manpage:`llvm-readobj(1)`
205