LLVM-DWARFUTIL(1)

📦
version 22.1.8 · 6 versions
, in fedora 44

✨ LLVM-DWARFUTIL ✨

okay bestie, welcome to llvm-dwarfutil — that's the LLVM manual, section 1 (general commands, iykyk) 🎀

💖 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. fr fr that's the whole job description.

In basic usage, it makes a semantic copy of the input to the output. And like… if you throw any options at it, the output may get modified along the way, e.g. by removing unused debug info. the way it just quietly upgrades your file while copying?? obsessed.

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. pipes slay 💅

The tool is still in active development. so like, it's in its growth era, be nice to it 🙈

🎀 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, and that abandoned debug info references address ranges using tombstone values. So when this option is specified, the tool removes debug info which is marked with the tombstone value. lowkey a cleanup queen 🧹
That option is enabled by default. ⭐
  • --odr-deduplication — Remove duplicated types (if "One Definition Rule" is supported by source language). Keeps the first type definition and removes other definitions, potentially significantly reducing the size of output debug info. it's giving "you already told me this, bestie" 💀
That option is enabled by default. ⭐
  • --help, -h — Print a summary of command line options. your little cheat sheet 🫶
  • --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. parallel processing era ⚡
  • --separate-debug-file — Generate separate file containing output debug info. Using llvm-dwarfutil with that option equals to the following set of commands:
llvm-objcopy --only-keep-debug in-file out-file.debug
llvm-objcopy --strip-debug in-file out-file
llvm-objcopy --add-gnu-debuglink=out-file.debug out-file

one flag doing the job of three commands?? main character energy fr 👑

  • --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) address 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. so pick your fighter: yapping or threading 😭
  • --verify — Run the DWARF verifier on the output DWARF debug info. vibe check on your debug info, no cap ✅
  • --version — Print the version of this program.

🌈 SUPPORTED FORMATS 🌈

The following formats are currently supported by llvm-dwarfutil:

  • ELF

(yes bestie, that's the whole list. ELF only. we love a focused icon 💜)

🍓 EXIT STATUS 🍓

llvm-dwarfutil exits with a non-zero exit code if there is an error. Otherwise, it exits with code 0. clean exit = happy exit ✨

🧚 BUGS 🧚

To report bugs, please visit <https://github.com/llvm/llvm-project/labels/tools:llvm-dwarfutil/>. tell them everything, they wanna know 🫶

👑 Author 👑

Maintained by the LLVM Team (<https://llvm.org/>).

2003-2026, LLVM Project

okay that's the whole page, bestie!! this one's from LLVM, version 22, dated 2026-07-16 — go forth and copy some debug info, ily, bye!! 💖✨🎀🦋

📦 where this page comes from