manpagez: man pages & more
man dwarfdump(1)
Home | html | info | man
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 disas-
     sembles the DWARF data found within the file. Only the .debug_info sec-
     tion is disassembled unless one of the --debug-XXXX or --all options are
     specified.

     The following options are available:

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

     --arch=ARCH
              Dump DWARF debug information for the specified CPU architecture.
              Architectures may be specified 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 SEC-
              TION 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.  Spec-
              ify the optional 'size' argument to show all byte count results
              using unit suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Ter-
              abyte 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 pat-
              tern 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=OFF-
              SET, --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 relationships 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-inlined, --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                        September 17, 2009                        Darwin

Mac OS X 10.6 - Generated Thu Sep 17 20:07:30 CDT 2009
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.