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