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
24              option can be specified multiple times, once  for  each  desired
25              architecture.  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
50              attribute) 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
71              machine-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>],
98       --debug-macro,  --debug-pubnames,   --debug-pubtypes,   --debug-ranges,
99       --debug-str,   --debug-str-offsets,   --debug-tu-index,  --debug-types,
100       --eh-frame, --gdb-index, --apple-names,  --apple-types,  --apple-names‐
101       paces, --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 (https://llvm.org/).
120
122       2003-2019, LLVM Project
123
124
125
126
1278                                 2019-04-25                 LLVM-DWARFDUMP(1)
Impressum