This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

dwarfdump(1)              BSD General Commands Manual             dwarfdump(1)

NAME
     dwarfdump -- dump DWARF debug information.

SYNOPSIS
     dwarfdump [options] file1 file2 ...

DESCRIPTION
     For each operand that names a mach-o or 32 bit ELF file, dwarfdump disassembles the DWARF data found
     within the file. Only the .debug_info section is disassembled unless one of the --debug-XXXX or --all
     options are specified.

     A list of flags and their descriptions:

     -a, --all
              Disassemble all supported DWARF sections.

     --arch=ARCH
              Dump DWARF debug information for the specified CPU architecture.  Architectures may be speci-fied specified
              fied by name or by number.  This option can be specified multiple times, once for each desired
              architecture.  All cpu architectures will be disassembled by default.

     -c, --show-children
              Show a DIE's children when using the --debug-info=OFFSET, --find, and --name options.

     -e, --english
              Print dwarf tags and attributes in a more readable format instead of using the DWARF TAG_ and
              AT_ definitions.

     --eh-frame[=SECTION]
              Dump exception handling frame information from the optional SECTION parameter.  The __eh_frame
              section will be dumped by default.

     --file-stats[=size]
              Show file composition statistics for any input files. Each file's contents are analyzed and
              broken down into byte counts for the following categories: symbol table, string table, text
              and code, DWARF debug information, STABS debug information, and other. When multiple files are
              specified, byte count totals for each category will be displayed at the end of the table.
              Specify the optional 'size' argument to show all byte count results using unit suffixes: Byte,
              Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte. This option can be useful in tracking the
              size and makeup of mach-o binary files, and also allows easy comparison between DWARF and
              STABS built binaries and related object files.

     -f PATTERN, --find=PATTERN
              Search for the exact text PATTERN in the .debug_pubnames section and print the matching debug
              information entries. Use the --regex option to have PATTERN become a regular expression for
              more flexible pattern matching.

              When there is no .debug_pubnames section or the name of the DIE you are looking for is not
              found in the .debug_pubnames section, try using the slower but more complete --name option.

     -F, --show-form
              Show DWARF form types after the DWARF attribute types.

     -h, -?, --help
              Show help and usage for this command.

     -i, --ignore-case
              Ignore case distinctions in when finding by name using strings or regular expressions.

     -n -PATTERN, --name=PATTERN
              Find and print all DIE entries whose name (DW_AT_name attribute) matches the exact text in
              PATTERN. Use the --regex option to have PATTERN become a regular expression for more flexible
              pattern matching.

     --lookup=ADDRESS
              Lookup ADDRESS in the debug information and print out the file, function, block and line table
              details.

     -o PATH, --out-file=PATH
              Redirect output to a file specified by PATH.

     -p, --show-parents
              Show a DIE's parent DIE objects when using the --debug-info=OFFSET, --find, and --name
              options.

     -r N, --recurse-depth=N
              Only recurse to a child depth of N when displaying the DWARF information.

     -x, --regex
              Treat any PATTERN strings as regular expressions when searching instead of just as an exact
              string match.

     -u, --uuid
              Show the UUID for each architecture.

     -v, --verbose
              Display verbose information when dumping. This can help to debug DWARF issues.

     --verify
              Verify the structure of the DWARF information by verifying the compile unit chains, die rela-tionships relationships
              tionships graph, and address ranges.

     --version
              Display the current version and build date of the dwarfdump binary.

     --debug-abbrev, --debug-aranges, --debug-frame[=OFFSET], --debug-info[=OFFSET], --debug-line[=OFFSET],
              --debug-macinfo[=OFFSET], --debug-pubnames[=PATTERN], --debug-pubtypes[=PATTERN], --debug-str
              Dump the specified DWARF section by name. Only the .debug_info section is disassembled by
              default. Some entries support adding a '=OFFSET' as a way to provide an optional offset of the
              exact entry to dump within the respective section. When an OFFSET is provided, only the entry
              at that offset will be dumped, else the entire section will be dumped. Some options support an
              optional '=PATTERN' parameter that will search the section for an entry with a matching name.
              Children of items at OFFSETs can be dumped by also using the --show-children option where
              applicable.

SEE ALSO
     dsymutil(1)

Darwin                           April 2, 2008                          Darwin