LLVM-CGDATA(1)

💖 LLVM-CGDATA(1) 💖

okay bestie, welcome to the LLVM manual section, page LLVM-CGDATA(1) — this is the glow-up guide for llvm-cgdata, the LLVM CodeGen Data Tool. buckle up, it's giving compiler-internals-slash-group-chat 💅

---

✨ NAME ✨

llvm-cgdata — the LLVM CodeGen Data Tool. yes that's the whole name, she's simple and she slays 🎀

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

so the llvm-cgdata utility parses raw codegen data that's embedded inside compiled binary files, and merges all of that into a single .cgdata file. iconic behaviour, honestly. it can also inspect and manipulate .cgdata files — multitasking queen 👑

right now, 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. efficiency?? we love her fr fr.

and the design is extensible, meaning more codegen summaries and optimization techniques can be added later. she's built to grow, no cap 🌈

---

👑 COMMANDS 👑

at least one of the following commands is required — you cannot just vibe in here with zero commands, bestie

• --convert — converts a .cgdata file from one format to another. glow-up, but for file formats ✨
• --merge — merges multiple raw codgen data in binaries into a single .cgdata file. (yes, the original says "codgen" — we keep the facts exactly as they are, even the typos, that's loyalty 💖)
• --show — shows summary information about a .cgdata file. the receipts, basically 🧾

---

💅 OPTIONS 💅

llvm-cgdata supports the following options:

• --format=[text|binary] — specifies the format of the output .cgdata file. pick your aesthetic: text or binary 💖
• --output=<string> — specifies the output file name. name her, she deserves it 🎀
• --cgdata-version — prints the version of the llvm-cgdata tool. who are you? who who, who who 🌟

---

🍓 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/). shoutout to the devs, they're the main characters fr 💜

---

⭐ COPYRIGHT ⭐

2003-2026, LLVM Project

---

okay that's the whole page, you ate that 💅✨ this was LLVM manual page, version 21, dated 2026-07-22. go forth and merge your codegen data, bestie — i'm obsessed with you 🦋🌸💖