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

OPTIONS

18       -a, --all
19              Disassemble all supported DWARF sections.
20
21       --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
27       -c, --show-children
28              Show  a debug info entry's children when using the --debug-info,
29              --find, and --name options.
30
31       -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
38       -F, --show-form
39              Show DWARF form types after the DWARF attribute types.
40
41       -h, --help
42              Show help and usage for this command.
43
44       -i, --ignore-case
45              Ignore case distinctions in when searching entries by name or by
46              regular expression.
47
48       -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
54       --lookup=<address>
55              Lookup <address> in the debug  information  and  print  out  the
56              file, function, block, and line table details.
57
58       -o <path>, --out-file=<path>
59              Redirect output to a file specified by <path>.
60
61       -p, --show-parents
62              Show  a  debug  info  entry's  parent  objects  when  using  the
63              --debug-info, --find, and --name options.
64
65       -r <n>, --recurse-depth=<n>
66              Only recurse to a maximum depth of <n> when dumping  debug  info
67              entries.
68
69       --statistics
70              Collect  debug info quality metrics and print the results as ma‐
71              chine-readable single-line JSON output.
72
73       -x, --regex
74              Treat any <pattern> strings as regular expressions when  search‐
75              ing instead of just as an exact string match.
76
77       -u, --uuid
78              Show the UUID for each architecture.
79
80       --diff Dump  the output in a format that is more friendly for comparing
81              DWARF output from two different files.
82
83       -v, --verbose
84              Display verbose information when dumping. This can help to debug
85              DWARF issues.
86
87       --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
92       --version
93              Display the version of the tool.
94
95       --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

EXIT STATUS

112       llvm-dwarfdump returns 0 if the input files were parsed and dumped suc‐
113       cessfully. Otherwise, it returns 1.
114

SEE ALSO

116       dsymutil(1)
117

AUTHOR

119       Maintained by The LLVM Team (http://llvm.org/).
120
122       2003-2023, LLVM Project
123
124
125
126
1277                                 2023-01-19                 LLVM-DWARFDUMP(1)
Impressum