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

NAME
     ddwwaarrffdduummpp - dump DWARF debug information.

SYNOPSIS
     ddwwaarrffdduummpp [options] file1 file2 ...

DESCRIPTION
     For each operand that names a mach-o or 32 bit ELF file, ddwwaarrffdduummpp disas-
     sembles the DWARF data found within the file. Only the .debuginfo sec-
     tion is disassembled unless one of the -debug-XXXX or -all options are
     specified.

     The following options are available:

     -aa,, --aallll
              Disassemble all supported DWARF sections.

     --aarrcchh==AARRCCHH
              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.

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

     -ee,, --eenngglliisshh
              Print dwarf tags and attributes in a more readable format
              instead of using the DWARF TAG and AT definitions.

     --eehh-ffrraammee[[==SSEECCTTIIOONN]]
              Dump exception handling frame information from the optional SEC-
              TION parameter.  The ehframe section will be dumped by
              default.

     --ffiillee-ssttaattss[[==ssiizzee]]
              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.

     -ff PATTERN, --ffiinndd==PPAATTTTEERRNN
              Search for the exact text PATTERN in the .debugpubnames 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 .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 -name option.

     -FF,, --sshhooww-ffoorrmm
              Show DWARF form types after the DWARF attribute types.

     -hh,, -??,, --hheellpp
              Show help and usage for this command.

     -ii,, --iiggnnoorree-ccaassee
              Ignore case distinctions in when finding by name using strings
              or regular expressions.

     -nn -PPAATTTTEERRNN,, --nnaammee==PPAATTTTEERRNN
              Find and print all DIE entries whose name (DWATname attribute)
              matches the exact text in PATTERN. Use the -regex option to
              have PATTERN become a regular expression for more flexible pat-
              tern matching.

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

     -oo PATH, --oouutt-ffiillee==PPAATTHH
              Redirect output to a file specified by PATH.

     -pp,, --sshhooww-ppaarreennttss
              Show a DIE's parent DIE objects when using the -debug-info=OFF-
              SET, -find, and -name options.

     -rr N, --rreeccuurrssee-ddeepptthh==NN
              Only recurse to a child depth of N when displaying the DWARF
              information.

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

     -uu,, --uuuuiidd
              Show the UUID for each architecture.

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

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

     --vveerrssiioonn
              Display the current version and build date of the ddwwaarrffdduummpp
              binary.

     --ddeebbuugg-aabbbbrreevv,, --ddeebbuugg-aarraannggeess,, --ddeebbuugg-ffrraammee[[==OOFFFFSSEETT]],,
              --ddeebbuugg-iinnffoo[[==OOFFFFSSEETT]],, --ddeebbuugg-iinnlliinneedd,, --ddeebbuugg-lliinnee[[==OOFFFFSSEETT]],,
              --ddeebbuugg-mmaacciinnffoo[[==OOFFFFSSEETT]],, --ddeebbuugg-ppuubbnnaammeess[[==PPAATTTTEERRNN]],,
              --ddeebbuugg-ppuubbttyyppeess[[==PPAATTTTEERRNN]],, --ddeebbuugg-ssttrr
              Dump the specified DWARF section by name. Only the .debuginfo
              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                         December 21, 2019                        Darwin