LLVM-CGDATA(1)

📦
version 22.1.8 · 6 versions
, in fedora 44

💖 LLVM-CGDATA(1) 💖

okay so bestie, welcome to the llvm-cgdata manual page — it lives in section 1 of the LLVM manuals, and it's literally the LLVM CodeGen Data Tool. yes, that's the whole name. no cap. 🦋

✨ NAME ✨

llvm-cgdata — the LLVM CodeGen Data Tool 👑

🌸 SYNOPSIS 🌸

llvm-cgdata [commands] [options] (<binaries>|<.cgdata>)

💅 DESCRIPTION 💅

so the llvm-cgdata utility is that girl: she parses raw codegen data that's embedded inside compiled binary files, and then she merges all of it into one single .cgdata file. she can also inspect and manipulate .cgdata files, because she contains multitudes. 🫶

rn the tool supports saving and restoring outlined hash trees and stable function maps — which means more efficient function outlining and function merging across modules in your subsequent compilations. it's giving efficiency. it's giving main character. ✨

and the design? extensible. so future codegen summaries and optimization techniques can just... be incorporated. the door is open, the vibe is immaculate, we love to see it. 💖

🎀 COMMANDS 🎀

bestie, you need at least one of these. minimum one. we don't do zero commands here. 🙈

  • --convert — converts a .cgdata file from one format to another. glow-up arc, but for file formats. 💅
  • --merge — merges multiple raw codegen data found in binaries into a single .cgdata file. bring everyone together, it's a reunion. 🫶
  • --show — shows summary information about a .cgdata file. little peek behind the curtain, very nosy of you, love that. 👀

⭐ OPTIONS ⭐

llvm-cgdata supports the following options, and yes, every single one matters:

  • --format=[text|binary] — specifies the format of the output .cgdata file. pick your fighter: text or binary. 🌈
  • --output=<string> — specifies the output file name. name her, bestie. 🎀
  • --cgdata-version — prints the version of the llvm-cgdata tool. slay, we love a version check. ⭐

🦋 EXAMPLES 🦋

to convert a .cgdata file from binary to text format: 🧚

$ llvm-cgdata --convert --format=text input.cgdata
--output=output.data

to merge multiple raw codegen data in object files into a single .cgdata file: 💜

$ llvm-cgdata --merge file1.o file2.o --output=merged.cgdata

to show summary information about a .cgdata file: 👑

$ llvm-cgdata --show input.cgdata

🌈 AUTHOR 🌈

maintained by the LLVM Team (https://llvm.org/). iconic behavior, honestly.

2003-2026, LLVM Project — periodt. 💅

okay so real talk: this page is from the LLVM man pages, dated 2026-07-16, and it's page 22 of that batch, tool version vibes courtesy of LLVM-CGDATA(1). that's the whole footer, bestie, we just gave it a cute outfit. 🎀✨

stay hydrated, read your manpages, and go merge something. 🫶🌸

📦 where this page comes from