Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
LLVM-DWARFUTIL(1)		      LLVM		       LLVM-DWARFUTIL(1)

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 "-" is specified for the input file, the input is  read  from  the  pro-
     gram'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
     --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.

     --odr-deduplication
	    Remove  duplicated	types  (if "One Definition Rule" is supported by
	    source language). Keeps first type definition and removes other def-
	    initions, potentially significantly reducing the size of output  de-
	    bug info.

	    That option is enabled by default.

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

     --no-garbage-collection
	    Disable --garbage-collection.

     --no-odr-deduplication
	    Disable --odr-deduplication.

     --no-separate-debug-file
	    Disable --separate-debug-file.

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

     --separate-debug-file
	    Generate  separate	file  containing  output   debug   info.   Using
	    llvm-dwarfutil  with that option equals to the following set of com-
	    mands:

	: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

     --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 and exec.

	       * maxpc:  -1  for all addresses and -2 for DWARF v4 (or less) ad-
		 dress ranges.

	       * universal: both bfd and maxpc.

	       * exec: match with address ranges of executable sections.

	       The value universal is used by default.

     --verbose
	    Enable verbose logging. This option disables multi-thread mode.

     --verify
	    Run the DWARF verifier on the output DWARF debug info.

     --version
	    Print the version of this program.

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.   Oth-
     erwise, 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-2026, LLVM Project

19				   2026-07-30		       LLVM-DWARFUTIL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=llvm-dwarfutil&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help