llvm-project/llvm/docs/CommandGuide
Alexey Lapshin 4539b44148 [Reland][Debuginfo][llvm-dwarfutil] llvm-dwarfutil dsymutil-like tool for ELF.
This patch implements proposal https://lists.llvm.org/pipermail/llvm-dev/2020-August/144579.html
llvm-dwarfutil - is a tool that is used for processing debug info(DWARF) located in built binary files to improve debug info quality, reduce debug info size. The patch currently implements smaller set of command-line options(comparing to the proposal):

```
./llvm-dwarfutil [options] <input file> <output file>

  --garbage-collection    Do garbage collection for debug info(default)
  -j <value>              Alias for --num-threads
  --no-garbage-collection Don`t do garbage collection for debug info
  --no-odr-deduplication  Don`t do ODR deduplication for debug types
  --no-odr                Alias for --no-odr-deduplication
  --no-separate-debug-file
                          Create single output file, containing debug tables(default)
  --num-threads <threads> Number of available threads for multi-threaded execution. Defaults to the number of cores on the current machine
  --odr-deduplication     Do ODR deduplication for debug types(default)
  --odr                   Alias for --odr-deduplication
  --separate-debug-file   Create two output files: file w/o debug tables and file with debug tables
  --tombstone [bfd,maxpc,exec,universal]
                          Tombstone value used as a marker of invalid address(default: universal)
    =bfd - Zero for all addresses and [1,1] for DWARF v4 (or less) address ranges and exec
    =maxpc - Minus 1 for all addresses and minus 2 for DWARF v4 (or less) address ranges
    =exec - Match with address ranges of executable sections
    =universal - Both: bfd and maxpc
```

Reviewed By: clayborg

Differential Revision: https://reviews.llvm.org/D86539
2022-07-19 15:11:36 +03:00
..
FileCheck.rst Update FileCheck docs after D95849. NFCI 2022-06-16 08:18:12 +00:00
bugpoint.rst
clang-tblgen.rst
dsymutil.rst [dsymutil] Automatically generate a reproducer when dsymutil crashes 2022-06-14 16:00:08 -07:00
index.rst [Reland][Debuginfo][llvm-dwarfutil] llvm-dwarfutil dsymutil-like tool for ELF. 2022-07-19 15:11:36 +03:00
lit.rst [test] Add lit helper for windows paths 2022-03-14 20:05:55 -07:00
llc.rst Add missing word in llc docs 2022-04-14 22:29:03 -04:00
lldb-tblgen.rst
lli.rst [docs][lli] Fix lli rst docs formatting 2022-01-19 21:54:15 +00:00
llvm-addr2line.rst
llvm-ar.rst [llvm-ar] Add --output to specify output directory 2022-06-29 10:00:43 -07:00
llvm-as.rst
llvm-bcanalyzer.rst [docs][tools] Remove old llvm-bcanalyzer options 2022-05-19 11:07:03 -07:00
llvm-config.rst [docs] [tools] Document and alphabetize all llvm-config command-line options 2022-03-31 08:44:10 +01:00
llvm-cov.rst [CommandLine] --help: print "-o <xxx>" instead of "-o=<xxx>" 2022-07-14 01:28:28 -07:00
llvm-cxxfilt.rst
llvm-cxxmap.rst
llvm-diff.rst
llvm-dis.rst
llvm-dwarfdump.rst [llvm-dwarfdump] --show-sources option to show all sources 2022-06-30 09:53:08 -07:00
llvm-dwarfutil.rst [Reland][Debuginfo][llvm-dwarfutil] llvm-dwarfutil dsymutil-like tool for ELF. 2022-07-19 15:11:36 +03:00
llvm-exegesis-analysis.png
llvm-exegesis.rst
llvm-extract.rst
llvm-ifs.rst [ifs] Add --strip-size flag 2022-05-14 18:50:20 +00:00
llvm-install-name-tool.rst Update Bug report URL to Github Issues 2022-01-06 17:33:25 +08:00
llvm-lib.rst
llvm-libtool-darwin.rst [llvm-libtool-darwin] Add -warnings_as_errors 2022-02-07 14:39:21 -08:00
llvm-link.rst
llvm-lipo.rst Update Bug report URL to Github Issues 2022-01-06 17:33:25 +08:00
llvm-locstats.rst
llvm-mca.rst [llvm-mca] Improve barriers for strict region marking (PR52198) 2022-01-21 11:25:05 +00:00
llvm-nm.rst [llvm-nm][docs] Document -W and -U 2022-05-23 09:58:54 -07:00
llvm-objcopy.rst [docs][llvm-objcopy] Fix unpaired `<align>`` 2022-07-13 10:14:26 -07:00
llvm-objdump.rst [llvm-objdump][docs] Fix documentation for offloading flags 2022-07-11 15:44:48 -04:00
llvm-otool.rst Update Bug report URL to Github Issues 2022-01-06 17:33:25 +08:00
llvm-pdbutil.rst
llvm-profdata.rst Fix "the the" typo in documentation and user facing strings 2022-05-05 17:52:08 +02:00
llvm-profgen.rst
llvm-ranlib.rst
llvm-readelf.rst [llvm-readobj] Add JSONScopedPrinter to llvm-readelf 2021-12-10 23:34:27 +00:00
llvm-readobj.rst Reland "[llvm-readobj][MachO] Add option to sort the symbol table before dumping (MachO only, for now)." 2022-03-31 14:21:41 -04:00
llvm-remark-size-diff.rst Recommit "[Docs] Add documentation for llvm-remark-size-diff" 2022-03-30 13:37:49 -07:00
llvm-size.rst Update Bug report URL to Github Issues 2022-01-06 17:33:25 +08:00
llvm-stress.rst
llvm-strings.rst Update Bug report URL to Github Issues 2022-01-06 17:33:25 +08:00
llvm-strip.rst Fix llvm-strip --only-keep-debug documentation for ELF 2022-03-18 06:49:05 +00:00
llvm-symbolizer.rst [Symbolize] Add log markup --filter to llvm-symbolizer. 2022-06-27 10:44:15 -07:00
llvm-tblgen.rst
llvm-tli-checker.rst Add llvm-tli-checker 2021-11-08 16:29:28 -08:00
locstats-compare.png
locstats-draw-plot.png
mlir-tblgen.rst
opt.rst [docs] Replace `opt -analyze` with better alternatives. 2022-02-10 15:38:31 -08:00
tblgen.rst