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       --statistics
88              Collect  debug info quality metrics and print the results as ma‐
89              chine-readable single-line JSON output.
90
91       --summarize-types
92              Abbreviate the description of type unit entries.
93
94       -x, --regex
95              Treat any <name> strings as regular expressions  when  searching
96              with --name. If --ignore-case is also specified, the regular ex‐
97              pression becomes case-insensitive.
98
99       -u, --uuid
100              Show the UUID for each architecture.
101
102       --diff Dump the output in a format that is more friendly for  comparing
103              DWARF output from two different files.
104
105       -v, --verbose
106              Display verbose information when dumping. This can help to debug
107              DWARF issues.
108
109       --verify
110              Verify the structure of the DWARF information by  verifying  the
111              compile  unit  chains,  DIE relationships graph, address ranges,
112              and more.
113
114       --version
115              Display the version of the tool.
116
117       --debug-abbrev, --debug-addr, --debug-aranges, --debug-cu-index,  --de‐
118       bug-frame   [=<offset>],   --debug-gnu-pubnames,  --debug-gnu-pubtypes,
119       --debug-info [=<offset>], --debug-line  [=<offset>],  --debug-line-str,
120       --debug-loc  [=<offset>],  --debug-loclists [=<offset>], --debug-macro,
121       --debug-names,  --debug-pubnames,   --debug-pubtypes,   --debug-ranges,
122       --debug-rnglists,  --debug-str,  --debug-str-offsets, --debug-tu-index,
123       --debug-types,  --eh-frame  [=<offset>],  --gdb-index,   --apple-names,
124       --apple-types, --apple-namespaces, --apple-objc
125              Dump  the  specified DWARF section by name. Only the .debug_info
126              section is shown by default.  Some  entries  support  adding  an
127              =<offset>  as  a  way to provide an optional offset of the exact
128              entry to dump within the respective section. When an  offset  is
129              provided, only the entry at that offset will be dumped, else the
130              entire section will be dumped.
131
132       @<FILE>
133              Read command-line options from <FILE>.
134

EXIT STATUS

136       llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
137       cessfully. Otherwise, it returns 1.
138

SEE ALSO

140       dsymutil(1)
141

AUTHOR

143       Maintained by the LLVM Team (https://llvm.org/).
144

COPYRIGHT

146       2003-2021, LLVM Project
147
148
149
150
15110                                2021-04-19                 LLVM-DWARFDUMP(1)