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:: --color
41
42 Use colors in the output for warnings and errors.
43
44.. option:: --demangle, -C
45
46 Display demangled symbol names in the output.
47
48.. option:: --dyn-relocations
49
50 Display the dynamic relocation entries.
51
52.. option:: --dyn-symbols, --dyn-syms
53
54 Display the dynamic symbol table.
55
56.. option:: --dynamic-table, --dynamic, -d
57
58 Display the dynamic table.
59
60.. option:: --cg-profile
61
62 Display the callgraph profile section.
63
64.. option:: --elf-hash-histogram, --histogram, -I
65
66 Display a bucket list histogram for dynamic symbol hash tables.
67
68.. option:: --elf-linker-options
69
70 Display the linker options section.
71
72.. option:: --elf-output-style=<value>
73
74 Format ELF information in the specified style. Valid options are ``LLVM`` and
75 ``GNU``. ``LLVM`` output is an expanded and structured format, whilst ``GNU``
76 (the default) output mimics the equivalent GNU :program:`readelf` output.
77
78.. option:: --elf-section-groups, --section-groups, -g
79
80 Display section groups.
81
82.. option:: --expand-relocs
83
84 When used with :option:`--relocations`, display each relocation in an expanded
85 multi-line format.
86
87.. option:: --file-headers, -h
88
89 Display file headers.
90
91.. option:: --gnu-hash-table
92
93 Display the GNU hash table for dynamic symbols.
94
95.. option:: --hash-symbols
96
97 Display the expanded hash table with dynamic symbol data.
98
99.. option:: --hash-table
100
101 Display the hash table for dynamic symbols.
102
103.. option:: --headers, -e
104
105 Equivalent to setting: :option:`--file-headers`, :option:`--program-headers`,
106 and :option:`--sections`.
107
108.. option:: --help
109
110 Display a summary of command line options.
111
112.. option:: --help-list
113
114 Display an uncategorized summary of command line options.
115
116.. option:: --hex-dump=<section[,section,...]>, -x
117
118 Display the specified section(s) as hexadecimal bytes. ``section`` may be a
119 section index or section name.
120
121.. option:: --needed-libs
122
123 Display the needed libraries.
124
125.. option:: --notes, -n
126
127 Display all notes.
128
129.. option:: --program-headers, --segments, -l
130
131 Display the program headers.
132
133.. option:: --raw-relr
134
135 Do not decode relocations in RELR relocation sections when displaying them.
136
137.. option:: --relocations, --relocs, -r
138
139 Display the relocation entries in the file.
140
141.. option:: --sections, --section-headers, -S
142
143 Display all sections.
144
145.. option:: --section-data
146
147 When used with :option:`--sections`, display section data for each section
148 shown. This option has no effect for GNU style output.
149
150.. option:: --section-details, -t
151
152 Display all section details. Used as an alternative to :option:`--sections`.
153
154.. option:: --section-mapping
155
156 Display the section to segment mapping.
157
158.. option:: --section-relocations
159
160 When used with :option:`--sections`, display relocations for each section
161 shown. This option has no effect for GNU style output.
162
163.. option:: --section-symbols
164
165 When used with :option:`--sections`, display symbols for each section shown.
166 This option has no effect for GNU style output.
167
168.. option:: --stackmap
169
170 Display contents of the stackmap section.
171
172.. option:: --stack-sizes
173
174 Display the contents of the stack sizes section(s), i.e. pairs of function
175 names and the size of their stack frames. Currently only implemented for GNU
176 style output.
177
178.. option:: --string-dump=<section[,section,...]>, -p
179
180 Display the specified section(s) as a list of strings. ``section`` may be a
181 section index or section name.
182
183.. option:: --symbols, --syms, -s
184
185 Display the symbol table.
186
187.. option:: --unwind, -u
188
189 Display unwind information.
190
191.. option:: --version
192
193 Display the version of the :program:`llvm-readelf` executable.
194
195.. option:: --version-info, -V
196
197 Display version sections.
198
199.. option:: @<FILE>
200
201 Read command-line options from response file `<FILE>`.
202
203EXIT STATUS
204-----------
205
206:program:`llvm-readelf` returns 0 under normal operation. It returns a non-zero
207exit code if there were any errors.
208
209SEE ALSO
210--------
211
212:manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`, :manpage:`llvm-readobj(1)`
213