diff options
author | Alexey Lapshin <a.v.lapshin@mail.ru> | 2022-07-19 12:16:24 +0300 |
---|---|---|
committer | Alexey Lapshin <a.v.lapshin@mail.ru> | 2022-07-19 12:17:47 +0300 |
commit | e717f91c96b5b046a34a823b44b21268c1c5fee1 (patch) | |
tree | 0eca06f6d09747e89a76dbf183d30dc3d5b9cb40 /llvm/docs/CommandGuide | |
parent | 61394636f099ebba3d3dc7e3382a1e63f751b911 (diff) | |
download | llvm-e717f91c96b5b046a34a823b44b21268c1c5fee1.zip llvm-e717f91c96b5b046a34a823b44b21268c1c5fee1.tar.gz llvm-e717f91c96b5b046a34a823b44b21268c1c5fee1.tar.bz2 |
Revert "[Debuginfo][llvm-dwarfutil] llvm-dwarfutil dsymutil-like tool for ELF."
This reverts commit e2147c26bd1522ad67a98836fbe94933eab869bb.
Diffstat (limited to 'llvm/docs/CommandGuide')
-rw-r--r-- | llvm/docs/CommandGuide/llvm-dwarfutil.rst | 123 |
1 files changed, 0 insertions, 123 deletions
diff --git a/llvm/docs/CommandGuide/llvm-dwarfutil.rst b/llvm/docs/CommandGuide/llvm-dwarfutil.rst deleted file mode 100644 index a939fd4..0000000 --- a/llvm/docs/CommandGuide/llvm-dwarfutil.rst +++ /dev/null @@ -1,123 +0,0 @@ -llvm-dwarfutil - A tool to copy and manipulate debug info -========================================================= - -.. program:: llvm-dwarfutil - -SYNOPSIS --------- - -:program:`llvm-dwarfutil` [*options*] *input* *output* - -DESCRIPTION ------------ - -:program:`llvm-dwarfutil` is a tool to copy and manipulate debug info. - -In basic usage, it makes a semantic copy of the input to the output. If any -options are specified, the output may be modified along the way, e.g. -by removing unused debug info. - -If "-" is specified for the input file, the input is read from the program's -standard input stream. If "-" is specified for the output file, the output -is written to the standard output stream of the program. - -The tool is still in active development. - -COMMAND-LINE OPTIONS --------------------- - -.. option:: --garbage-collection - - Removes pieces of debug information related to discarded sections. - When the linker does section garbage collection the abandoned debug info - is left behind. Such abandoned debug info references address ranges using - tombstone values. Thus, when this option is specified, the tool removes - debug info which is marked with the tombstone value. - - That option is enabled by default. - -.. option:: --odr-deduplication - - Remove duplicated types (if "One Definition Rule" is supported by source - language). Keeps first type definition and removes other definitions, - potentially significantly reducing the size of output debug info. - - That option is enabled by default. - -.. option:: --help, -h - - Print a summary of command line options. - -.. option:: --no-garbage-collection - - Disable :option:`--garbage-collection`. - -.. option:: --no-odr-deduplication - - Disable :option:`--odr-deduplication`. - -.. option:: --no-separate-debug-file - - Disable :option:`--separate-debug-file`. - -.. option:: --num-threads=<n>, -j - - Specifies the maximum number (`n`) of simultaneous threads to use - for processing. - -.. option:: --separate-debug-file - - Generate separate file containing output debug info. Using - :program:`llvm-dwarfutil` with that option equals to the - following set of commands: - -.. code-block:: console - - :program:`llvm-objcopy` --only-keep-debug in-file out-file.debug - :program:`llvm-objcopy` --strip-debug in-file out-file - :program:`llvm-objcopy` --add-gnu-debuglink=out-file.debug out-file - -.. option:: --tombstone=<value> - - <value> can be one of the following values: - - - `bfd`: zero for all addresses and [1,1] for DWARF v4 (or less) address - ranges. - - - `maxpc`: -1 for all addresses and -2 for DWARF v4 (or less) address ranges. - - - `universal`: both `bfd` and `maxpc`. - - - `exec`: match with address ranges of executable sections. - - The value `universal` is used by default. - -.. option:: --verbose - - Enable verbose logging. This option disables multi-thread mode. - -.. option:: --verify - - Run the DWARF verifier on the output DWARF debug info. - -.. option:: --version - - Print the version of this program. - -SUPPORTED FORMATS ------------------ - -The following formats are currently supported by :program:`llvm-dwarfutil`: - -ELF - -EXIT STATUS ------------ - -:program:`llvm-dwarfutil` exits with a non-zero exit code if there is an error. -Otherwise, it exits with code 0. - -BUGS ----- - -To report bugs, please visit <https://github.com/llvm/llvm-project/labels/tools:llvm-dwarfutil/>. |