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 op‐
28              tion can be specified multiple times, once for each desired  ar‐
29              chitecture.  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 op‐
54              tions 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 at‐
61              tribute) 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 ma‐
92              chine-readable single-line JSON output. The output format is de‐
93              scribed 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 ex‐
101              pression 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, --de‐
122       bug-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, --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
136              The  --debug-macro  option  prints both the .debug_macro and the
137              .debug_macinfo sections.
138
139              The --debug-frame and --eh-frame options are aliases,  in  cases
140              where both sections are present one command outputs both.
141
142       @<FILE>
143              Read command-line options from <FILE>.
144

FORMAT OF STATISTICS OUTPUT

146       The  --statistics option generates single-line JSON output representing
147       quality metrics of the processed debug info. These metrics  are  useful
148       to  compare changes between two compilers, particularly for judging the
149       effect that a change to the compiler has on the debug info quality.
150
151       The output is formatted as key-value pairs. The first pair  contains  a
152       version number. The following naming scheme is used for the keys:
153
154variables ==> local variables and parameters
155
156local vars ==> local variables
157
158params ==> formal parameters
159
160       For aggregated values, the following keys are used:
161
162sum_of_all_variables(...) ==> the sum applied to all variables
163
164#bytes ==> the number of bytes
165
166#variables  - entry values ... ==> the number of variables exclud‐
167            ing the entry values etc.
168

EXIT STATUS

170       llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
171       cessfully. Otherwise, it returns 1.
172

SEE ALSO

174       dsymutil(1)
175

AUTHOR

177       Maintained by the LLVM Team (https://llvm.org/).
178
180       2003-2023, LLVM Project
181
182
183
184
18514                                2023-01-19                 LLVM-DWARFDUMP(1)
Impressum