OS Manuals

/usr/bin/llvm-dwarfdump

Low-level virtual machine 19 - core frameworks

From llvm-19 19.1.7-r31 (os), captured 2026-11-05 by running llvm-dwarfdump --help (exit 0). permalink

OVERVIEW: pretty-print DWARF debug information in object files and debug info archives.

USAGE: llvm-dwarfdump [options] <input object files or .dSYM bundles>

OPTIONS:

Color Options:

  --color                       - Use colors in output (default=autodetect)

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.

  -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.
  --dwo                         - Dump the non skeleton DIE in the .dwo or .dwp file after dumping the skeleton DIE from the main executable. This allows dumping the .dwo files with resolved addresses.
  --error-display=<value>       - Set the level of detail and summary to display when verifying (implies --verify)
    =quiet                      -   Only display whether errors occurred.
    =summary                    -   Display only a summary of the errors found.
    =details                    -   Display each error in detail but no summary.
    =full                       -   Display each error as well as a summary. [default]
  -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.
  --find-all-apple              - Print every debug information entry in the accelerator tables.
  -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 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.
  --verify-json=<filename.json> - Output JSON-formatted error summary to the specified file. (Implies --verify)
  -x                            - Alias for --regex

Pass @FILE as argument to read options from FILE.
Options (68)
OptionDescriptionSource
--color- Use colors in output (default=autodetect)help
--help- Display available options (--help-hidden for more)help
--help-list- Display list of available options (--help-list-hidden for more)help
--version- Display the version of this programhelp
-a- Alias for --allhelp
--all- Dump all debug info sectionshelp
--apple-names- Dump the .apple_names sectionhelp
--apple-namespaces- Dump the .apple_namespaces sectionhelp
--apple-objc- Dump the .apple_objc sectionhelp
--apple-types- Dump the .apple_types sectionhelp
--debug-abbrev- Dump the .debug_abbrev sectionhelp
--debug-addr- Dump the .debug_addr sectionhelp
--debug-aranges- Dump the .debug_aranges sectionhelp
--debug-cu-index- Dump the .debug_cu_index sectionhelp
--debug-frame offset- Dump the .debug_frame sectionhelp
--debug-gnu-pubnames- Dump the .debug_gnu_pubnames sectionhelp
--debug-gnu-pubtypes- Dump the .debug_gnu_pubtypes sectionhelp
--debug-info offset- Dump the .debug_info sectionhelp
--debug-line offset- Dump the .debug_line sectionhelp
--debug-line-str- Dump the .debug_line_str sectionhelp
--debug-loc offset- Dump the .debug_loc sectionhelp
--debug-loclists offset- Dump the .debug_loclists sectionhelp
--debug-macro- Dump the .debug_macro sectionhelp
--debug-names- Dump the .debug_names sectionhelp
--debug-pubnames- Dump the .debug_pubnames sectionhelp
--debug-pubtypes- Dump the .debug_pubtypes sectionhelp
--debug-ranges- Dump the .debug_ranges sectionhelp
--debug-rnglists- Dump the .debug_rnglists sectionhelp
--debug-str- Dump the .debug_str sectionhelp
--debug-str-offsets- Dump the .debug_str_offsets sectionhelp
--debug-tu-index- Dump the .debug_tu_index sectionhelp
--debug-types offset- Dump the .debug_types sectionhelp
--eh-frame- Alias for --debug-framehelp
--gdb-index- Dump the .gdb_index sectionhelp
-F- Alias for --show-form.help
--arch string- Dump debug information for the specified CPU architecture only.help
-c- Alias for --show-children.help
--diff- Emit diff-friendly output by omitting offsets and addresses.help
--dwo- Dump the non skeleton DIE in the .dwo or .dwp file after dumping the skeleton DIE from the main executable.help
--error-display value- Set the level of detail and summary to display when verifying (implies --verify) =quiet - Only display whether errors occurred.help
-f- Alias for --find.help
--find name- Search for the exact match for <name> in the accelerator tables and print the matching debug information entries.help
--find-all-apple- Print every debug information entry in the accelerator tables.help
-i- Alias for --ignore-case.help
--ignore-case- Ignore case distinctions when using --name.help
--lookup address- Lookup <address> in the debug information and print out any available file, function, block and line table details.help
-n- Alias for --namehelp
--name pattern- Find and print all debug info entries whose name (DW_AT_name attribute) matches the exact text in <pattern>.help
-o filename- Redirect output to the specified file.help
-p- Alias for --show-parents.help
--parent-recurse-depth N- Only recurse to a depth of N when displaying parents of debug info entries.help
--quiet- Use with -verify to not emit to STDOUT.help
-r- Alias for --recurse-depth.help
--recurse-depth N- Only recurse to a depth of N when displaying children of debug info entries.help
--regex- Treat any <pattern> strings as regular expressions when searching with --name.help
--show-children- Show a debug info entry's children when selectively printing entries.help
--show-form- Show DWARF form types after the DWARF attribute types.help
--show-parents- Show a debug info entry's parents when selectively printing entries.help
--show-section-sizes- Show the sizes of all debug sections, expressed in bytes.help
--show-sources- Show the sources across all compilation units.help
--statistics- Emit JSON-formatted debug info quality metrics.help
--summarize-types- Abbreviate the description of type unit entries.help
-u- Alias for --uuid.help
--uuid- Show the UUID for each architecture.help
-v- Alias for --verbose.help
--verbose- Print more low-level encoding details.help
--verify- Verify the DWARF debug info.help
-x- Alias for --regexhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.