.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH LLVM-DWARFDUMP "1" "February 2024" "llvm-dwarfdump 15" "User Commands"
.SH NAME
llvm-dwarfdump \- manual page for llvm-dwarfdump 15
.SH DESCRIPTION
OVERVIEW: pretty\-print DWARF debug information in object files and debug info archives.
.PP
USAGE: llvm\-dwarfdump [options] <input object files or .dSYM bundles>
.PP
OPTIONS:
.PP
Color Options:
.HP
\fB\-\-color\fR                    \- Use colors in output (default=autodetect)
.PP
Generic Options:
.HP
\fB\-\-help\fR                     \- Display available options (\fB\-\-help\-hidden\fR for more)
.HP
\fB\-\-help\-list\fR                \- Display list of available options (\fB\-\-help\-list\-hidden\fR for more)
.HP
\fB\-\-version\fR                  \- Display the version of this program
.PP
Section\-specific Dump Options:
These control which sections are dumped. Where applicable these parameters take an optional =<offset> argument to dump only the entry at the specified offset.
.HP
\fB\-a\fR                         \- Alias for \fB\-\-all\fR
.HP
\fB\-\-all\fR                      \- Dump all debug info sections
.HP
\fB\-\-apple\-names\fR              \- Dump the .apple_names section
.HP
\fB\-\-apple\-namespaces\fR         \- Dump the .apple_namespaces section
.HP
\fB\-\-apple\-objc\fR               \- Dump the .apple_objc section
.HP
\fB\-\-apple\-types\fR              \- Dump the .apple_types section
.HP
\fB\-\-debug\-abbrev\fR             \- Dump the .debug_abbrev section
.HP
\fB\-\-debug\-addr\fR               \- Dump the .debug_addr section
.HP
\fB\-\-debug\-aranges\fR            \- Dump the .debug_aranges section
.HP
\fB\-\-debug\-cu\-index\fR           \- Dump the .debug_cu_index section
.HP
\fB\-\-debug\-frame[=\fR<offset>]     \- Dump the .debug_frame section
.HP
\fB\-\-debug\-gnu\-pubnames\fR       \- Dump the .debug_gnu_pubnames section
.HP
\fB\-\-debug\-gnu\-pubtypes\fR       \- Dump the .debug_gnu_pubtypes section
.HP
\fB\-\-debug\-info[=\fR<offset>]      \- Dump the .debug_info section
.HP
\fB\-\-debug\-line[=\fR<offset>]      \- Dump the .debug_line section
.HP
\fB\-\-debug\-line\-str\fR           \- Dump the .debug_line_str section
.HP
\fB\-\-debug\-loc[=\fR<offset>]       \- Dump the .debug_loc section
.HP
\fB\-\-debug\-loclists[=\fR<offset>]  \- Dump the .debug_loclists section
.HP
\fB\-\-debug\-macro\fR              \- Dump the .debug_macro section
.HP
\fB\-\-debug\-names\fR              \- Dump the .debug_names section
.HP
\fB\-\-debug\-pubnames\fR           \- Dump the .debug_pubnames section
.HP
\fB\-\-debug\-pubtypes\fR           \- Dump the .debug_pubtypes section
.HP
\fB\-\-debug\-ranges\fR             \- Dump the .debug_ranges section
.HP
\fB\-\-debug\-rnglists\fR           \- Dump the .debug_rnglists section
.HP
\fB\-\-debug\-str\fR                \- Dump the .debug_str section
.HP
\fB\-\-debug\-str\-offsets\fR        \- Dump the .debug_str_offsets section
.HP
\fB\-\-debug\-tu\-index\fR           \- Dump the .debug_tu_index section
.HP
\fB\-\-debug\-types[=\fR<offset>]     \- Dump the .debug_types section
.HP
\fB\-\-eh\-frame\fR                 \- Alias for \fB\-\-debug\-frame\fR
.HP
\fB\-\-gdb\-index\fR                \- Dump the .gdb_index section
.PP
Specific Options:
.HP
\fB\-F\fR                         \- Alias for \fB\-\-show\-form\fR.
.HP
\fB\-\-arch=\fR<string>            \- Dump debug information for the specified CPU architecture only. Architectures may be specified by name or by number. This option can be specified multiple times, once for each desired architecture.
.HP
\fB\-c\fR                         \- Alias for \fB\-\-show\-children\fR.
.HP
\fB\-\-diff\fR                     \- Emit diff\-friendly output by omitting offsets and addresses.
.HP
\fB\-f\fR                         \- Alias for \fB\-\-find\fR.
.HP
\fB\-\-find=\fR<name>              \- Search for the exact match for <name> in the accelerator tables and print the matching debug information entries. When no accelerator tables are available, the slower but more complete \fB\-name\fR option can be used instead.
.HP
\fB\-i\fR                         \- Alias for \fB\-\-ignore\-case\fR.
.HP
\fB\-\-ignore\-case\fR              \- Ignore case distinctions when using \fB\-\-name\fR.
.HP
\fB\-\-lookup=\fR<address>         \- Lookup <address> in the debug information and print out any available file, function, block and line table details.
.HP
\fB\-n\fR                         \- Alias for \fB\-\-name\fR
.TP
\fB\-\-name=\fR<pattern>           \- Find and print all debug info entries whose name (DW_AT_name attribute) matches the exact text in <pattern>.
When used with the the \fB\-regex\fR option <pattern> is interpreted as a regular expression.
.HP
\fB\-o\fR <filename>              \- Redirect output to the specified file.
.HP
\fB\-p\fR                         \- Alias for \fB\-\-show\-parents\fR.
.HP
\fB\-\-parent\-recurse\-depth=\fR<N> \- Only recurse to a depth of N when displaying parents of debug info entries.
.HP
\fB\-\-quiet\fR                    \- Use with \fB\-verify\fR to not emit to STDOUT.
.HP
\fB\-r\fR                         \- Alias for \fB\-\-recurse\-depth\fR.
.HP
\fB\-\-recurse\-depth=\fR<N>        \- Only recurse to a depth of N when displaying children of debug info entries.
.HP
\fB\-\-regex\fR                    \- Treat any <pattern> strings as regular expressions when searching with \fB\-\-name\fR. If \fB\-\-ignore\-case\fR is also specified, the regular expression becomes case\-insensitive.
.HP
\fB\-\-show\-children\fR            \- Show a debug info entry's children when selectively printing entries.
.HP
\fB\-\-show\-form\fR                \- Show DWARF form types after the DWARF attribute types.
.HP
\fB\-\-show\-parents\fR             \- Show a debug info entry's parents when selectively printing entries.
.HP
\fB\-\-show\-section\-sizes\fR       \- Show the sizes of all debug sections, expressed in bytes.
.HP
\fB\-\-show\-sources\fR             \- Show the sources across all compilation units.
.HP
\fB\-\-statistics\fR               \- Emit JSON\-formatted debug info quality metrics.
.HP
\fB\-\-summarize\-types\fR          \- Abbreviate the description of type unit entries.
.HP
\fB\-u\fR                         \- Alias for \fB\-\-uuid\fR.
.HP
\fB\-\-uuid\fR                     \- Show the UUID for each architecture.
.HP
\fB\-v\fR                         \- Alias for \fB\-\-verbose\fR.
.HP
\fB\-\-verbose\fR                  \- Print more low\-level encoding details.
.HP
\fB\-\-verify\fR                   \- Verify the DWARF debug info.
.HP
\fB\-x\fR                         \- Alias for \fB\-\-regex\fR
.PP
Pass @FILE as argument to read options from FILE.