1LLVM-DWARFDUMP(1)                    LLVM                    LLVM-DWARFDUMP(1)
2
3
4

NAME

6       llvm-dwarfdump - dump and verify DWARF debug information
7

SYNOPSIS

9       llvm-dwarfdump [options] [filename ...]
10

DESCRIPTION

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
17       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

OPTIONS

22       -a, --all
23              Dump all supported DWARF sections.
24
25       --arch=<arch>
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 default.
30
31       -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
36       --color
37              Use colors in output.
38
39       -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
46       -F, --show-form
47              Show DWARF form types after the DWARF attribute types.
48
49       -h, --help
50              Show help and usage for this command.
51
52       --help-list
53              Show  help  and  usage  for  this  command  without grouping the
54              options into categories.
55
56       -i, --ignore-case
57              Ignore case distinctions when using --name.
58
59       -n <name>, --name=<name>
60              Find and print all debug info  entries  whose  name  (DW_AT_name
61              attribute) is <name>.
62
63       --lookup=<address>
64              Look  up  <address>  in  the debug information and print out the
65              file, function, block, and line table details.
66
67       -o <path>
68              Redirect output to a file specified by <path>, where  -  is  the
69              standard output stream.
70
71       -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
76       --parent-recurse-depth=<N>
77              When  displaying  debug  info entry parents, only show them to a
78              maximum depth of <N>.
79
80       --quiet
81              Use with --verify to not emit to STDOUT.
82
83       -r <N>, --recurse-depth=<N>
84              When displaying debug info entries, only show children to a max‐
85              imum depth of <N>.
86
87       --show-section-sizes
88              Show the sizes of all debug sections, expressed in bytes.
89
90       --statistics
91              Collect  debug  info  quality  metrics  and print the results as
92              machine-readable single-line JSON output. The output  format  is
93              described in the section below (FORMAT OF STATISTICS OUTPUT).
94
95       --summarize-types
96              Abbreviate the description of type unit entries.
97
98       -x, --regex
99              Treat  any  <name> strings as regular expressions when searching
100              with --name. If --ignore-case is  also  specified,  the  regular
101              expression becomes case-insensitive.
102
103       -u, --uuid
104              Show the UUID for each architecture.
105
106       --diff Dump  the output in a format that is more friendly for comparing
107              DWARF output from two different files.
108
109       -v, --verbose
110              Display verbose information when dumping. This can help to debug
111              DWARF issues.
112
113       --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
118       --version
119              Display the version of the tool.
120
121       --debug-abbrev,    --debug-addr,   --debug-aranges,   --debug-cu-index,
122       --debug-frame[=<offset>],  --debug-gnu-pubnames,  --debug-gnu-pubtypes,
123       --debug-info  [=<offset>],  --debug-line [=<offset>], --debug-line-str,
124       --debug-loc [=<offset>], --debug-loclists  [=<offset>],  --debug-macro,
125       --debug-names,   --debug-pubnames,   --debug-pubtypes,  --debug-ranges,
126       --debug-rnglists, --debug-str,  --debug-str-offsets,  --debug-tu-index,
127       --debug-types   [=<offset>],   --eh-frame   [=<offset>],   --gdb-index,
128       --apple-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
136       @<FILE>
137              Read command-line options from <FILE>.
138

FORMAT OF STATISTICS OUTPUT

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
145       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
148          · variables ==> local variables and parameters
149
150          · local vars ==> local variables
151
152          · params ==> formal parameters
153
154       For aggregated values, the following keys are used:
155
156          · sum_of_all_variables(...) ==> the sum applied to all variables
157
158          · #bytes ==> the number of bytes
159
160          · #variables  - entry values ... ==> the number of variables exclud‐
161            ing the entry values etc.
162

EXIT STATUS

164       llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
165       cessfully. Otherwise, it returns 1.
166

SEE ALSO

168       dsymutil(1)
169

AUTHOR

171       Maintained by the LLVM Team (https://llvm.org/).
172
174       2003-2020, LLVM Project
175
176
177
178
17911                                2020-10-15                 LLVM-DWARFDUMP(1)
Impressum