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

NAME
     dwarfdump -- dump DWARF debug information found in 32 bit, 64 bit and fat
     mach-o files, Apple repository database files, or 32 bit ELF files.

SYNOPSIS
     dwarfdump [options] file1 file2 ...

DESCRIPTION
     For each operand that names a mach-o or ELF file dwarfdump disassembles
     the DWARF data found within the file. Any Apple type repository database
     files will have their debug information tables disassembled.

     A list of flags and their descriptions:

     -a,, --all
              Dump disassembly for all DWARF sections -- by default only the
              .debuginfo section is disassembled, or individual sections can
              be specified by using the --debug-X options.

     --arch==ARCH
              Dump DWARF debug information for specified CPU architecture
              type(s). Valid architectures are 'ppc', 'ppc64', 'i386' and
              'all'. Specify this option multiple times, once for each cpu
              architecture to be included. All cpu architectures will be
              included by default.

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

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

     --file-stats[==size]
              Show the file composition statistics for any input files break-
              ing down the contents into symbol table, string table, text and
              code, dwarf debug info, stabs debug info and other byte sizes.
              All input files will be totalled up. Specify the optional argu-
              ment of 'size' to show all results in file sizes use unit suf-
              fixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte
              in order to reduce the number of digits to three or less using
              base 2 for sizes.

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

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

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

     -g,, --debug
              Print very verbose information useful for debugging issues with
              this tool.

     -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 -PATERN,, --name==PATERN
              Find and print all DIE entries whose name (DWATname attribute)
              matches the exact text in PATERN. Use the -x or --regex option
              to have PATERN become a regular expression for more flexible
              pattern matching.

     --lookup==ADRES
              Lookup ADRES 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=OF-
              SET, -f or --find, and -n or --name options.

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

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

     -u,, --uuid
              Show the UID 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[==OFSET],,
              --debug-info[==OFSET],, --debug-line[==OFSET],,
              --debug-macinfo[==OFSET],, --debug-pubnames,, --debug-str
              Dump the specified DWARF section by name. The default case is to
              only dump the DWARF .debuginfo section. Some entries support
              adding a '=OFSET' as a way to provide an optional offset of the
              exact entry to dump within the respective section. When an OF-
              SET is provided, only the entry at that offset will be dumped,
              else the entire section will be dumped. Children of items at
              OFSETs can be dumped by also using the -c or --show-children
              option where applicable.

SEE ALSO
     dsymutil(1)

Darwin                           March 6, 2010                          Darwin