|
121
|
1 llvm-dwarfdump - dump and verify DWARF debug information
|
|
|
2 ========================================================
|
77
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
3
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
4 SYNOPSIS
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
5 --------
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
6
|
|
121
|
7 :program:`llvm-dwarfdump` [*options*] [*filename ...*]
|
77
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
8
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
9 DESCRIPTION
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
10 -----------
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
11
|
|
121
|
12 :program:`llvm-dwarfdump` parses DWARF sections in object files,
|
|
|
13 archives, and `.dSYM` bundles and prints their contents in
|
|
|
14 human-readable form. Only the .debug_info section is printed unless one of
|
|
|
15 the section-specific options or :option:`--all` is specified.
|
77
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
16
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
17 OPTIONS
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
18 -------
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
19
|
|
121
|
20 .. option:: -a, --all
|
|
|
21
|
|
|
22 Disassemble all supported DWARF sections.
|
|
|
23
|
|
|
24 .. option:: --arch=<arch>
|
|
|
25
|
|
|
26 Dump DWARF debug information for the specified CPU architecture.
|
|
|
27 Architectures may be specified by name or by number. This
|
|
|
28 option can be specified multiple times, once for each desired
|
|
|
29 architecture. All CPU architectures will be printed by
|
|
|
30 default.
|
|
|
31
|
|
|
32 .. option:: -c, --show-children
|
|
|
33
|
|
|
34 Show a debug info entry's children when using
|
|
|
35 the :option:`--debug-info`, :option:`--find`,
|
|
|
36 and :option:`--name` options.
|
|
|
37
|
|
|
38 .. option:: -f <name>, --find=<name>
|
|
|
39
|
|
|
40 Search for the exact text <name> in the accelerator tables
|
|
|
41 and print the matching debug information entries.
|
|
|
42 When there is no accelerator tables or the name of the DIE
|
|
|
43 you are looking for is not found in the accelerator tables,
|
|
|
44 try using the slower but more complete :option:`--name` option.
|
|
|
45
|
|
|
46 .. option:: -F, --show-form
|
|
|
47
|
|
|
48 Show DWARF form types after the DWARF attribute types.
|
|
|
49
|
|
|
50 .. option:: -h, --help
|
|
|
51
|
|
|
52 Show help and usage for this command.
|
|
|
53
|
|
|
54 .. option:: -i, --ignore-case
|
|
|
55
|
|
|
56 Ignore case distinctions in when searching entries by name
|
|
|
57 or by regular expression.
|
|
|
58
|
|
|
59 .. option:: -n <pattern>, --name=<pattern>
|
|
|
60
|
|
|
61 Find and print all debug info entries whose name
|
|
|
62 (`DW_AT_name` attribute) matches the exact text in
|
|
|
63 <pattern>. Use the :option:`--regex` option to have
|
|
|
64 <pattern> become a regular expression for more flexible
|
|
|
65 pattern matching.
|
|
|
66
|
|
|
67 .. option:: --lookup=<address>
|
|
|
68
|
|
|
69 Lookup <address> in the debug information and print out the file,
|
|
|
70 function, block, and line table details.
|
|
|
71
|
|
|
72 .. option:: -o <path>, --out-file=<path>
|
|
|
73
|
|
|
74 Redirect output to a file specified by <path>.
|
77
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
75
|
|
121
|
76 .. option:: -p, --show-parents
|
|
|
77
|
|
|
78 Show a debug info entry's parent objects when using the
|
|
|
79 :option:`--debug-info`, :option:`--find`, and
|
|
|
80 :option:`--name` options.
|
|
|
81
|
|
|
82 .. option:: -r <n>, --recurse-depth=<n>
|
|
|
83
|
|
|
84 Only recurse to a maximum depth of <n> when dumping debug info
|
|
|
85 entries.
|
|
|
86
|
|
|
87 .. option:: --statistics
|
|
|
88
|
|
|
89 Collect debug info quality metrics and print the results
|
|
|
90 as machine-readable single-line JSON output.
|
|
|
91
|
|
|
92 .. option:: -x, --regex
|
|
|
93
|
|
|
94 Treat any <pattern> strings as regular expressions when searching
|
|
|
95 instead of just as an exact string match.
|
|
|
96
|
|
|
97 .. option:: -u, --uuid
|
|
|
98
|
|
|
99 Show the UUID for each architecture.
|
|
|
100
|
|
|
101 .. option:: --diff
|
|
|
102
|
|
|
103 Dump the output in a format that is more friendly for comparing
|
|
|
104 DWARF output from two different files.
|
|
|
105
|
|
|
106 .. option:: -v, --verbose
|
|
|
107
|
|
|
108 Display verbose information when dumping. This can help to debug
|
|
|
109 DWARF issues.
|
|
|
110
|
|
|
111 .. option:: --verify
|
|
|
112
|
|
|
113 Verify the structure of the DWARF information by verifying the
|
|
|
114 compile unit chains, DIE relationships graph, address
|
|
|
115 ranges, and more.
|
|
|
116
|
|
|
117 .. option:: --version
|
|
|
118
|
|
|
119 Display the version of the tool.
|
|
|
120
|
|
|
121 .. option:: --debug-abbrev, --debug-aranges, --debug-cu-index, --debug-frame [=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=<offset>], --debug-line [=<offset>], --debug-loc [=<offset>], --debug-macro, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-str, --debug-str-offsets, --debug-tu-index, --debug-types, --eh-frame, --gdb-index, --apple-names, --apple-types, --apple-namespaces, --apple-objc
|
|
|
122
|
|
|
123 Dump the specified DWARF section by name. Only the
|
|
|
124 `.debug_info` section is shown by default. Some entries
|
|
|
125 support adding an `=<offset>` as a way to provide an
|
|
|
126 optional offset of the exact entry to dump within the
|
|
|
127 respective section. When an offset is provided, only the
|
|
|
128 entry at that offset will be dumped, else the entire
|
|
|
129 section will be dumped. Children of items at a specific
|
|
|
130 offset can be dumped by also using the
|
|
|
131 :option:`--show-children` option where applicable.
|
77
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
132
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
133 EXIT STATUS
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
134 -----------
|
Kaito Tokumori <e105711@ie.u-ryukyu.ac.jp>
parents:
diff
changeset
|
135
|
|
95
|
136 :program:`llvm-dwarfdump` returns 0 if the input files were parsed and dumped
|
|
|
137 successfully. Otherwise, it returns 1.
|
|
121
|
138
|
|
|
139 SEE ALSO
|
|
|
140 --------
|
|
|
141
|
|
|
142 :manpage:`dsymutil(1)`
|
