LLVM-DWARFDUMP(1)

🎀 NAME 🎀

okay bestie, this is the llvm-dwarfdump manual page — the one titled LLVM-DWARFDUMP(1), from the User Commands section, and it's the manual page for llvm-dwarfdump 15. yes, section 1 of the manual. we're doing this. 💅

---

🌸 DESCRIPTION 🌸

🦋 OVERVIEW 🦋

pretty-print DWARF debug information in object files and debug info archives. that's the whole vibe. ✨

🚀 USAGE 🚀

---

# 💅 OPTIONS 💅

okay, options time. buckle up, bestie. 🫶

## 🌈 Color Options 🌈

- **`--color`** — use colors in output (`default=autodetect`). cute.

## ✨ Generic Options ✨

- **`--help`** — display available options (`--help-hidden` for more).
- **`--help-list`** — display list of available options (`--help-list-hidden` for more).
- **`--version`** — display the version of this program.

## 📚 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. iconic. 🎀

- **`-a`** — alias for `--all`.
- **`--all`** — dump all debug info sections.
- **`--apple-names`** — dump the `.apple_names` section.
- **`--apple-namespaces`** — dump the `.apple_namespaces` section.
- **`--apple-objc`** — dump the `.apple_objc` section.
- **`--apple-types`** — dump the `.apple_types` section.
- **`--debug-abbrev`** — dump the `.debug_abbrev` section.
- **`--debug-addr`** — dump the `.debug_addr` section.
- **`--debug-aranges`** — dump the `.debug_aranges` section.
- **`--debug-cu-index`** — dump the `.debug_cu_index` section.
- **`--debug-frame[=<offset>]`** — dump the `.debug_frame` section.
- **`--debug-gnu-pubnames`** — dump the `.debug_gnu_pubnames` section.
- **`--debug-gnu-pubtypes`** — dump the `.debug_gnu_pubtypes` section.
- **`--debug-info[=<offset>]`** — dump the `.debug_info` section.
- **`--debug-line[=<offset>]`** — dump the `.debug_line` section.
- **`--debug-line-str`** — dump the `.debug_line_str` section.
- **`--debug-loc[=<offset>]`** — dump the `.debug_loc` section.
- **`--debug-loclists[=<offset>]`** — dump the `.debug_loclists` section.
- **`--debug-macro`** — dump the `.debug_macro` section.
- **`--debug-names`** — dump the `.debug_names` section.
- **`--debug-pubnames`** — dump the `.debug_pubnames` section.
- **`--debug-pubtypes`** — dump the `.debug_pubtypes` section.
- **`--debug-ranges`** — dump the `.debug_ranges` section.
- **`--debug-rnglists`** — dump the `.debug_rnglists` section.
- **`--debug-str`** — dump the `.debug_str` section.
- **`--debug-str-offsets`** — dump the `.debug_str_offsets` section.
- **`--debug-tu-index`** — dump the `.debug_tu_index` section.
- **`--debug-types[=<offset>]`** — dump the `.debug_types` section.
- **`--eh-frame`** — alias for `--debug-frame`.
- **`--gdb-index`** — dump the `.gdb_index` section.

## 🫶 Specific Options 🫶

- **`-F`** — alias for `--show-form`.
- **`--arch=<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. 👑
- **`-c`** — alias for `--show-children`.
- **`--diff`** — emit diff-friendly output by omitting offsets and addresses.
- **`-f`** — alias for `--find`.
- **`--find=<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 `-name` option can be used instead.
- **`-i`** — alias for `--ignore-case`.
- **`--ignore-case`** — ignore case distinctions when using `--name`.
- **`--lookup=<address>`** — lookup `<address>` in the debug information and print out any available file, function, block and line table details.
- **`-n`** — alias for `--name`.
- **`--name=<pattern>`** — find and print all debug info entries whose name (`DW_AT_name` attribute) matches the exact text in `<pattern>`. when used with the `-regex` option, `<pattern>` is interpreted as a regular expression.
- **`-o <filename>`** — redirect output to the specified file.
- **`-p`** — alias for `--show-parents`.
- **`--parent-recurse-depth=<N>`** — only recurse to a depth of `N` when displaying parents of debug info entries.
- **`--quiet`** — use with `-verify` to not emit to `STDOUT`.
- **`-r`** — alias for `--recurse-depth`.
- **`--recurse-depth=<N>`** — only recurse to a depth of `N` when displaying children of debug info entries.
- **`--regex`** — treat any `<pattern>` strings as regular expressions when searching with `--name`. if `--ignore-case` is also specified, the regular expression becomes case-insensitive.
- **`--show-children`** — show a debug info entry's children when selectively printing entries.
- **`--show-form`** — show DWARF form types after the DWARF attribute types.
- **`--show-parents`** — show a debug info entry's parents when selectively printing entries.
- **`--show-section-sizes`** — show the sizes of all debug sections, expressed in bytes.
- **`--show-sources`** — show the sources across all compilation units.
- **`--statistics`** — emit JSON-formatted debug info quality metrics.
- **`--summarize-types`** — abbreviate the description of type unit entries.
- **`-u`** — alias for `--uuid`.
- **`--uuid`** — show the UUID for each architecture.
- **`-v`** — alias for `--verbose`.
- **`--verbose`** — print more low-level encoding details.
- **`--verify`** — verify the DWARF debug info.
- **`-x`** — alias for `--regex`.

pass `@FILE` as argument to read options from `FILE`.

---

mwah 💋 — this page is from `llvm-dwarfdump` 15, dated July 2023, and it's the `LLVM-DWARFDUMP(1)` manual page. periodt. 🫶