LLVM-CGDATA(1)

💅 LLVM-CGDATA(1) — the LLVM CodeGen Data Tool

okay so bestie, welcome to the LLVM manual page for llvm-cgdata, no cap. this is the one you're gonna want bookmarked ✨

---

🌸 NAME 🌸

llvm-cgdata — the LLVM CodeGen Data Tool 🎀

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

so the llvm-cgdata utility parses raw codegen data embedded in compiled binary files and merges them into a single .cgdata file. it can also inspect and manipulate .cgdata files — icon behavior, honestly 👑

currently, the tool supports saving and restoring outlined hash trees and stable function maps, which lets you get more efficient function outlining and function merging across modules in subsequent compilations. it's giving "glow up between builds" 💅

and the design is extensible, meaning they can totally add more codegen summaries and optimization techniques later — main character energy, always room to grow 🌱

🚀 COMMANDS 🚀

bestie, you need at least one of these. not optional, it's literally the whole point:

• --convert — converts a .cgdata file from one format to another 🔄
• --merge — merges multiple raw codgen data in binaries into a single .cgdata file 🧬
• --show — shows summary information about a .cgdata file 👀

⭐ OPTIONS ⭐

llvm-cgdata supports the following options, and yes i listed every single one 🫶

• --format=[text|binary] — specify the format of the output .cgdata file. pick your era 💖
• --output=<string> — specify the output file name 📝
• --cgdata-version — prints the version of the llvm-cgdata tool. cute little flex ✨

🍓 EXAMPLES 🍓

converting binary → text, slay edition

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

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

fr fr type it exactly like that, the --output=output.data goes on the next line the way it's written here 🙈

merging a whole group chat of object files

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

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

it's giving "bringing everyone together" 🫶

peeking at what's inside

to show summary information about a .cgdata file:

$ llvm-cgdata --show input.cgdata

lowkey my fave command, it's the vibe check of the whole tool 💀

---

👑 Author 👑

maintained by the LLVM Team (https://llvm.org/). we stan 🫡

🎀 Copyright 🎀

2003-2026, LLVM Project

---

and that's the whole page bestie, go forth and merge 🌈💜

sign-off time: this lovely number is version 23, dated 2026-10-20 — LLVM-CGDATA(1), LLVM's very own. iykyk ✨🎀