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