From: Adrian Prantl Date: Tue, 3 Oct 2017 23:46:57 +0000 (+0000) Subject: Add a manpage for llvm-dwarfdump. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f4e8e0363a4da761cc25ceec41a6c8a669e6b6db;p=llvm Add a manpage for llvm-dwarfdump. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@314863 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt index 4437610146c..f1f93c7a228 100644 --- a/docs/CMakeLists.txt +++ b/docs/CMakeLists.txt @@ -112,6 +112,7 @@ if (LLVM_ENABLE_SPHINX) if (${SPHINX_OUTPUT_MAN}) add_sphinx_target(man llvm) + add_sphinx_target(man llvm-dwarfdump) endif() endif() diff --git a/docs/CommandGuide/llvm-dwarfdump.rst b/docs/CommandGuide/llvm-dwarfdump.rst index 30c18adb771..9d204ffe6f8 100644 --- a/docs/CommandGuide/llvm-dwarfdump.rst +++ b/docs/CommandGuide/llvm-dwarfdump.rst @@ -1,30 +1,137 @@ -llvm-dwarfdump - print contents of DWARF sections -================================================= +llvm-dwarfdump - dump and verify DWARF debug information +======================================================== SYNOPSIS -------- -:program:`llvm-dwarfdump` [*options*] [*filenames...*] +:program:`llvm-dwarfdump` [*options*] [*filename ...*] DESCRIPTION ----------- -:program:`llvm-dwarfdump` parses DWARF sections in the object files -and prints their contents in human-readable form. +:program:`llvm-dwarfdump` parses DWARF sections in object files, +archives, and `.dSYM` bundles and prints their contents in +human-readable form. Only the .debug_info section is printed unless one of +the section-specific options or :option:`--all` is specified. OPTIONS ------- -.. option:: -debug-dump=section +.. option:: -a, --all - Specify the DWARF section to dump. - For example, use ``abbrev`` to dump the contents of ``.debug_abbrev`` section, - ``loc.dwo`` to dump the contents of ``.debug_loc.dwo`` etc. - See ``llvm-dwarfdump --help`` for the complete list of supported sections. - Use ``all`` to dump all DWARF sections. It is the default. + Disassemble all supported DWARF sections. + +.. option:: --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 printed by + default. + +.. option:: -c, --show-children + + Show a debug info entry's children when using + the :option:`--debug-info`, :option:`--find`, + and :option:`--name` options. + +.. option:: -f , --find= + + Search for the exact text in the accelerator tables + and print the matching debug information entries. + When there is no accelerator tables or the name of the DIE + you are looking for is not found in the accelerator tables, + try using the slower but more complete :option:`--name` option. + +.. option:: -F, --show-form + + Show DWARF form types after the DWARF attribute types. + +.. option:: -h, --help + + Show help and usage for this command. + +.. option:: -i, --ignore-case + + Ignore case distinctions in when searching entries by name + or by regular expression. + +.. option:: -n , --name= + + Find and print all debug info entries whose name + (`DW_AT_name` attribute) matches the exact text in + . Use the :option:`--regex` option to have + become a regular expression for more flexible + pattern matching. + +.. option:: --lookup=
+ + Lookup
in the debug information and print out the file, + function, block, and line table details. + +.. option:: -o , --out-file= + + Redirect output to a file specified by . + +.. option:: -p, --show-parents + + Show a debug info entry's parent objects when using the + :option:`--debug-info`, :option:`--find`, and + :option:`--name` options. + +.. option:: -r , --recurse-depth= + + Only recurse to a maximum depth of when dumping debug info + entries. + +.. option:: -x, --regex + + Treat any strings as regular expressions when searching + instead of just as an exact string match. + +.. option:: -u, --uuid + + Show the UUID for each architecture. + +.. option:: --diff + + Dump the output in a format that is more friendly for comparing + DWARF output from two different files. + +.. option:: -v, --verbose + + Display verbose information when dumping. This can help to debug + DWARF issues. + +.. option:: --verify + + Verify the structure of the DWARF information by verifying the + compile unit chains, DIE relationships graph, address + ranges, and more. + +.. option:: --version + + Display the version of the tool. + +.. option:: --debug-abbrev, --debug-aranges, --debug-cu-index, --debug-frame [=], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=], --debug-line [=], --debug-loc [=], --debug-macro, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-str, --debug-str-offsets, --debug-tu-index, --debug-types, --eh-frame, --gdb-index, --apple-names, --apple-types, --apple-namespaces, --apple-objc + + Dump the specified DWARF section by name. Only the + `.debug_info` section is shown by default. Some entries + support adding an `=` 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. Children of items at a specific + offset can be dumped by also using the + :option:`--show-children` option where applicable. EXIT STATUS ----------- :program:`llvm-dwarfdump` returns 0 if the input files were parsed and dumped successfully. Otherwise, it returns 1. + +SEE ALSO +-------- + +:manpage:`dsymutil(1)`