1LLVM-DWARFDUMP(1) LLVM LLVM-DWARFDUMP(1)
2
6 llvm-dwarfdump - dump and verify DWARF debug information
7
9 llvm-dwarfdump [options] [filename ...]
10
12 llvm-dwarfdump parses DWARF sections in object files, archives, and
13 .dSYM bundles and prints their contents in human-readable form. Only
14 the .debug_info section is printed unless one of the section-specific
15 options or --all is specified.
16 If no input file is specified, a.out is used instead. If - is used as
18 the input file, llvm-dwarfdump reads the input from its standard input
19 stream.
20
22 -a, --all
23 Dump all supported DWARF sections.
24 --arch=<arch>
26 Dump DWARF debug information for the specified CPU architecture.
27 Architectures may be specified by name or by number. This op‐
28 tion can be specified multiple times, once for each desired ar‐
29 chitecture. All CPU architectures will be printed by default.
30 -c, --show-children
32 Show a debug info entry's children when selectively printing
33 with the =<offset> argument of --debug-info, or options such as
34 --find or --name.
35 --color
37 Use colors in output.
38 -f <name>, --find=<name>
40 Search for the exact text <name> in the accelerator tables and
41 print the matching debug information entries. When there is no
42 accelerator tables or the name of the DIE you are looking for is
43 not found in the accelerator tables, try using the slower but
44 more complete --name option.
45 -F, --show-form
47 Show DWARF form types after the DWARF attribute types.
48 -h, --help
50 Show help and usage for this command.
51 --help-list
53 Show help and usage for this command without grouping the op‐
54 tions into categories.
55 -i, --ignore-case
57 Ignore case distinctions when using --name.
58 -n <name>, --name=<name>
60 Find and print all debug info entries whose name (DW_AT_name at‐
61 tribute) is <name>.
62 --lookup=<address>
64 Look up <address> in the debug information and print out the
65 file, function, block, and line table details.
66 -o <path>
68 Redirect output to a file specified by <path>, where - is the
69 standard output stream.
70 -p, --show-parents
72 Show a debug info entry's parents when selectively printing with
73 the =<offset> argument of --debug-info, or options such as
74 --find or --name.
75 --parent-recurse-depth=<N>
77 When displaying debug info entry parents, only show them to a
78 maximum depth of <N>.
79 --quiet
81 Use with --verify to not emit to STDOUT.
82 -r <N>, --recurse-depth=<N>
84 When displaying debug info entries, only show children to a max‐
85 imum depth of <N>.
86 --show-section-sizes
88 Show the sizes of all debug sections, expressed in bytes.
89 --statistics
91 Collect debug info quality metrics and print the results as ma‐
92 chine-readable single-line JSON output. The output format is de‐
93 scribed in the section below (FORMAT OF STATISTICS OUTPUT).
94 --summarize-types
96 Abbreviate the description of type unit entries.
97 -x, --regex
99 Treat any <name> strings as regular expressions when searching
100 with --name. If --ignore-case is also specified, the regular ex‐
101 pression becomes case-insensitive.
102 -u, --uuid
104 Show the UUID for each architecture.
105 --diff Dump the output in a format that is more friendly for comparing
107 DWARF output from two different files.
108 -v, --verbose
110 Display verbose information when dumping. This can help to debug
111 DWARF issues.
112 --verify
114 Verify the structure of the DWARF information by verifying the
115 compile unit chains, DIE relationships graph, address ranges,
116 and more.
117 --version
119 Display the version of the tool.
120 --debug-abbrev, --debug-addr, --debug-aranges, --debug-cu-index, --de‐
122 bug-frame[=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --de‐
123 bug-info [=<offset>], --debug-line [=<offset>], --debug-line-str, --de‐
124 bug-loc [=<offset>], --debug-loclists [=<offset>], --debug-macro, --de‐
125 bug-names, --debug-pubnames, --debug-pubtypes, --debug-ranges, --de‐
126 bug-rnglists, --debug-str, --debug-str-offsets, --debug-tu-index, --de‐
127 bug-types [=<offset>], --eh-frame [=<offset>], --gdb-index, --ap‐
128 ple-names, --apple-types, --apple-namespaces, --apple-objc
129 Dump the specified DWARF section by name. Only the .debug_info
130 section is shown by default. Some entries support adding an
131 =<offset> as a way to provide an optional offset of the exact
132 entry to dump within the respective section. When an offset is
133 provided, only the entry at that offset will be dumped, else the
134 entire section will be dumped.
135 @<FILE>
137 Read command-line options from <FILE>.
138
140 The :--statistics option generates single-line JSON output representing
141 quality metrics of the processed debug info. These metrics are useful
142 to compare changes between two compilers, particularly for judging the
143 effect that a change to the compiler has on the debug info quality.
144 The output is formatted as key-value pairs. The first pair contains a
146 version number. The following naming scheme is used for the keys:
147 • variables ==> local variables and parameters
149 • local vars ==> local variables
151 • params ==> formal parameters
153 For aggregated values, the following keys are used:
155 • sum_of_all_variables(...) ==> the sum applied to all variables
157 • #bytes ==> the number of bytes
159 • #variables - entry values ... ==> the number of variables exclud‐
161 ing the entry values etc.
162
164 llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
165 cessfully. Otherwise, it returns 1.
166
168 dsymutil(1)
169
171 Maintained by the LLVM Team (https://llvm.org/).
172
174 2003-2021, LLVM Project
17512 2021-05-17 LLVM-DWARFDUMP(1)