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
18 -a, --all
19 Disassemble all supported DWARF sections.
20 --arch=<arch>
22 Dump DWARF debug information for the specified CPU architecture.
23 Architectures may be specified by name or by number. This op‐
24 tion can be specified multiple times, once for each desired ar‐
25 chitecture. All CPU architectures will be printed by default.
26 -c, --show-children
28 Show a debug info entry's children when using the --debug-info,
29 --find, and --name options.
30 -f <name>, --find=<name>
32 Search for the exact text <name> in the accelerator tables and
33 print the matching debug information entries. When there is no
34 accelerator tables or the name of the DIE you are looking for is
35 not found in the accelerator tables, try using the slower but
36 more complete --name option.
37 -F, --show-form
39 Show DWARF form types after the DWARF attribute types.
40 -h, --help
42 Show help and usage for this command.
43 -i, --ignore-case
45 Ignore case distinctions in when searching entries by name or by
46 regular expression.
47 -n <pattern>, --name=<pattern>
49 Find and print all debug info entries whose name (DW_AT_name at‐
50 tribute) matches the exact text in <pattern>. Use the --regex
51 option to have <pattern> become a regular expression for more
52 flexible pattern matching.
53 --lookup=<address>
55 Lookup <address> in the debug information and print out the
56 file, function, block, and line table details.
57 -o <path>, --out-file=<path>
59 Redirect output to a file specified by <path>.
60 -p, --show-parents
62 Show a debug info entry's parent objects when using the
63 --debug-info, --find, and --name options.
64 -r <n>, --recurse-depth=<n>
66 Only recurse to a maximum depth of <n> when dumping debug info
67 entries.
68 --statistics
70 Collect debug info quality metrics and print the results as ma‐
71 chine-readable single-line JSON output.
72 -x, --regex
74 Treat any <pattern> strings as regular expressions when search‐
75 ing instead of just as an exact string match.
76 -u, --uuid
78 Show the UUID for each architecture.
79 --diff Dump the output in a format that is more friendly for comparing
81 DWARF output from two different files.
82 -v, --verbose
84 Display verbose information when dumping. This can help to debug
85 DWARF issues.
86 --verify
88 Verify the structure of the DWARF information by verifying the
89 compile unit chains, DIE relationships graph, address ranges,
90 and more.
91 --version
93 Display the version of the tool.
94 --debug-abbrev, --debug-aranges, --debug-cu-index, --debug-frame
96 [=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info
97 [=<offset>], --debug-line [=<offset>], --debug-loc [=<offset>], --de‐
98 bug-macro, --debug-pubnames, --debug-pubtypes, --debug-ranges, --de‐
99 bug-str, --debug-str-offsets, --debug-tu-index, --debug-types,
100 --eh-frame, --gdb-index, --apple-names, --apple-types, --apple-name‐
101 spaces, --apple-objc
102 Dump the specified DWARF section by name. Only the .debug_info
103 section is shown by default. Some entries support adding an
104 =<offset> as a way to provide an optional offset of the exact
105 entry to dump within the respective section. When an offset is
106 provided, only the entry at that offset will be dumped, else the
107 entire section will be dumped. Children of items at a specific
108 offset can be dumped by also using the --show-children option
109 where applicable.
110
112 llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
113 cessfully. Otherwise, it returns 1.
114
116 dsymutil(1)
117
119 Maintained by The LLVM Team (http://llvm.org/).
120
122 2003-2023, LLVM Project
1237 2023-01-19 LLVM-DWARFDUMP(1)