LLVM-PROFGEN(1)

📦
version 14.0.6 · 8 versions
, in ubuntu questing

💖 LLVM-PROFGEN 💖

okay bestie, so this is the page for llvm-profgen from the LLVM manual — yes, that LLVM. it's a whole vibe and it's lowkey iconic, so let's get into it ✨

🌸 NAME 🌸

llvm-profgen — the LLVM SPGO profile generation tool. it makes profiles. that's the whole thing. slay 💅

✨ SYNOPSIS ✨

llvm-profgen [commands] [options]

no cap, that's it. commands first, options after, go off 🫶

🦋 DESCRIPTION 🦋

so the way that llvm-profgen works is: it takes perf script data files you already have, and it generates a profile data file out of them, for sample-based profile guided optimization — which the cool kids call SPGO. that's the entire job description, and it ate 💖

🎀 COMMANDS 🎀

bestie listen. you need at least one of these. it's not optional. the tool literally cannot function without one of them. periodt.
  • --perfscript=<string[,string,...]> — path (or paths, comma-separated) of the perf-script trace, the one Linux perf made with the script command. ⚠️ important little detail: the raw perf.data should have been profiled with -b. don't forget the -b, i'm begging 😭
  • --binary=<string[,string,...]> — path (or paths, comma-separated) of the input profiled binary files. the main characters of this whole operation fr fr 👑
  • --output=<string> — path of the output profile file. where your hard work goes to live 🌈

👑 OPTIONS 👑

llvm-profgen supports these options, and yes we're doing all of them:

  • --format=[text|binary|extbinary|compbinary|gcc] — picks the format of the generated profile. the supported formats are text, binary, extbinary, compbinary, and gcc — and if you want the full tea on what each one means, go check out llvm-profdata, it explains them. iykyk 📖
  • --show-mmap-events — prints mmap events. that's the whole thing, she's simple and she's thriving 🌸
  • --show-disassembly — prints disassembled code. disassembly girlies rise 🙈
  • --x86-asm-syntax=[att|intel] — picks whether the assembly code gets printed in AT&T syntax (which is the default, just so you know) or in Intel syntax. choose your fighter ⚔️

💜 AUTHOR 💜

maintained by the LLVM Team</> — their link is https://llvm.org/ and they are, frankly, carrying the entire compiler ecosystem on their backs 🫶

2003-2025, LLVM Project — two whole decades of this, iconic behaviour honestly 👑

and that's the page bestie!! 💖 this was LLVM-PROFGEN(1) from the LLVM manual, sitting pretty at version 14, dated 2025-05-22, brought to you by the LLVM Project. go generate some profiles, you absolute legend 🦋✨🎀

📦 where this page comes from