Index: llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst =================================================================== --- llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst +++ llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst @@ -14,6 +14,10 @@ human-readable form. Only the .debug_info section is printed unless one of the section-specific options or :option:`--all` is specified. +If no input file is specified, `a.out` is used instead. If `-` is used as the +input file, :program:`llvm-dwarfdump` reads the input from its standard input +stream. + OPTIONS ------- @@ -35,6 +39,10 @@ the :option:`--debug-info`, :option:`--find`, and :option:`--name` options. +.. option:: --color + + Use colors in output. + .. option:: -f , --find= Search for the exact text in the accelerator tables @@ -51,6 +59,11 @@ Show help and usage for this command. +.. option:: --help-list + + Show help and usage for this command without grouping the options + into categories. + .. option:: -i, --ignore-case Ignore case distinctions when searching. @@ -70,7 +83,8 @@ .. option:: -o - Redirect output to a file specified by . + Redirect output to a file specified by , where `-` is the + standard output stream. .. option:: -p, --show-parents @@ -78,9 +92,18 @@ :option:`--debug-info`, :option:`--find`, and :option:`--name` options. -.. option:: -r , --recurse-depth= +.. option:: --parent-recurse-depth= + + Only recurse to a maximum depth of when displaying parents of + debug info entries. + +.. option:: --quiet - Only recurse to a maximum depth of when dumping debug info + Use with :option:`--verify` to not emit to `STDOUT`. + +.. option:: -r , --recurse-depth= + + Only recurse to a maximum depth of when dumping debug info entries. .. option:: --statistics @@ -88,6 +111,10 @@ Collect debug info quality metrics and print the results as machine-readable single-line JSON output. +.. option:: --summarize-types + + Abbreviate the description of type unit entries. + .. option:: -x, --regex Treat any strings as regular expressions when searching @@ -117,7 +144,7 @@ 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 +.. option:: --debug-abbrev, --debug-addr, --debug-aranges, --debug-cu-index, --debug-frame [=], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=], --debug-line [=], --debug-line-str, --debug-loc [=], --debug-loclists [=], --debug-macro, --debug-names, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-rnglists, --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 @@ -129,6 +156,10 @@ offset can be dumped by also using the :option:`--show-children` option where applicable. +.. option:: @ + + Read command-line options from ``. + EXIT STATUS -----------