xref: /freebsd/usr.bin/clang/llvm-dwarfutil/llvm-dwarfutil.1 (revision 19fae0f66023a97a9b464b3beeeabb2081f575b3)
Man page generated from reStructuredText.
. . .nr rst2man-indent-level 0 . \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .rstReportMargin pre:
. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
"LLVM-DWARFUTIL" "1" "2023-05-24" "16" "LLVM"
NAME
llvm-dwarfutil - A tool to copy and manipulate debug info
SYNOPSIS
llvm-dwarfutil [options] input output
DESCRIPTION
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 \(dq-\(dq is specified for the input file, the input is read from the program\(aqs standard input stream. If \(dq-\(dq 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
NDENT 0.0

--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. NINDENT NDENT 0.0

--odr-deduplication Remove duplicated types (if \(dqOne Definition Rule\(dq 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. NINDENT NDENT 0.0

--help, -h Print a summary of command line options. NINDENT NDENT 0.0

--no-garbage-collection Disable \%--garbage-collection. NINDENT NDENT 0.0

--no-odr-deduplication Disable \%--odr-deduplication. NINDENT NDENT 0.0

--no-separate-debug-file Disable \%--separate-debug-file. NINDENT NDENT 0.0

--num-threads=<n>, -j Specifies the maximum number (n) of simultaneous threads to use for processing. NINDENT NDENT 0.0

--separate-debug-file Generate separate file containing output debug info. Using llvm-dwarfutil with that option equals to the following set of commands: NINDENT NDENT 0.0 NDENT 3.5

:program:\(gallvm-objcopy\(ga --only-keep-debug in-file out-file.debug
:program:\(gallvm-objcopy\(ga --strip-debug in-file out-file
:program:\(gallvm-objcopy\(ga --add-gnu-debuglink=out-file.debug out-file
NINDENT NINDENT NDENT 0.0

--tombstone=<value> <value> can be one of the following values: NDENT 7.0 NDENT 3.5 NDENT 0.0

\(bu 2
bfd: zero for all addresses and [1,1] for DWARF v4 (or less) address ranges and exec.
\(bu 2
maxpc: -1 for all addresses and -2 for DWARF v4 (or less) address ranges.
\(bu 2
universal: both bfd and maxpc.
\(bu 2
exec: match with address ranges of executable sections. NINDENT The value universal is used by default. NINDENT NINDENT NINDENT NDENT 0.0

--verbose Enable verbose logging. This option disables multi-thread mode. NINDENT NDENT 0.0

--verify Run the DWARF verifier on the output DWARF debug info. NINDENT NDENT 0.0

--version Print the version of this program. NINDENT

SUPPORTED FORMATS
The following formats are currently supported by llvm-dwarfutil: ELF
EXIT STATUS
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/>.
AUTHOR
Maintained by the LLVM Team (https://llvm.org/).
COPYRIGHT
2003-2023, LLVM Project Generated by docutils manpage writer.
.