LLVM-CGDATA(1)

💖 llvm-cgdata — the LLVM CodeGen Data Tool 💖

okay bestie, welcome to the llvm-cgdata manual page (that's LLVM-CGDATA(1) for the girlies keeping track, part of the LLVM fam ✨). this lil tool is genuinely so useful and nobody talks about her enough, so sit down, grab a strawberry 🍓, and let's get into it.

---

🌸 NAME 🌸

llvm-cgdata — the LLVM CodeGen Data Tool. that's the whole name, she's simple like that 💅

---

✨ SYNOPSIS ✨

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

so yeah, you feed her commands, you feed her options, and then you point her at either your binaries or your .cgdata files. one or the other, she knows what to do 🫶

---

🦋 DESCRIPTION 🦋

the llvm-cgdata utility parses raw codegen data embedded in compiled binary files and merges them into a single .cgdata file. iconic behavior, honestly. but wait, there's more — she can also inspect and manipulate .cgdata files after the fact. main character with range 😭

right now, the tool supports saving and restoring outlined hash trees and stable function maps, which is how you get more efficient function outlining and function merging across modules in subsequent compilations. so like, she's doing the work now so future-you's compilations are faster. that's called investment, periodt 💜

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

---

👑 COMMANDS 👑

okay so here's the thing: you need at least one of these. she's not gonna guess what you want, bestie. at least one, minimum, that's the vibe check:

• --convert — convert a .cgdata file from one format to another. glow-up but for file formats 💅
• --merge — merge multiple raw codegen data in binaries into a single .cgdata file. girl math but it adds up 🔥
• --show — show summary information about a .cgdata file. just a little peek, a lil gossip session with your data 🙈

---

🎀 OPTIONS 🎀

llvm-cgdata supports the following options:

• --format=[text|binary] — specify the format of the output .cgdata file. text or binary, pick your fighter ⭐
• --output=<string> — specify the output file name. where she's gonna drop the goods 🍓
• --cgdata-version — print the version of the llvm-cgdata tool. sometimes you just gotta know who you're talking to 😌

---

🌈 EXAMPLES 🌈

convert a .cgdata file from binary to text format:

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

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

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

show summary information about a .cgdata file:

$ llvm-cgdata --show input.cgdata

see? not scary. she's literally just a girl 🧚

---

💜 AUTHOR 💜

maintained by the LLVM Team</c> (https://llvm.org/). the whole squad, holding it down 🫶

---

🌸 COPYRIGHT 🌸

2003-2025, LLVM Project — twenty-two years of excellence and she's still serving looks 👑

---

okay that's the whole page bestie, you're officially a llvm-cgdata girlie now. go merge something. slay 💅✨

this has been llvm-cgdata from LLVM 20, dated 2025-09-03 — stay iconic, drink water, and remember: the manual page is LLVM-CGDATA(1) and she ate 💖🎀🦋